org.omg.DynamicAny
Interface DynValueOperations

All Superinterfaces:
DynAnyOperations, DynValueCommonOperations
All Known Subinterfaces:
DynValue
All Known Implementing Classes:
_DynValueStub

public interface DynValueOperations
extends DynAnyOperations, DynValueCommonOperations

Defines operations, applicable to DynValue. From the view point of DynAny, the Value is very much like structure. However, differently from the structure, the value type can also have private members. The private members of DynValue are also accessible via this interface, but this possibility should only be used in applications like in debuggers or inter-orb bridges. Unlike structure, the value can also be equal to null.


Method Summary
 TCKind current_member_kind()
          Get the kind of the current member.
 String current_member_name()
          Get the name of the current member.
 NameDynAnyPair[] get_members_as_dyn_any()
          Get all members as an array of the named DynAny's.
 NameValuePair[] get_members()
          Get all members as an array of the named Any's.
 void set_members_as_dyn_any(NameDynAnyPair[] value)
          Set all members from the array of the named Any's.
 void set_members(NameValuePair[] value)
          Set all members from the array of the named Any's.
 
Methods inherited from interface org.omg.DynamicAny.DynValueCommonOperations
is_null, set_to_null, set_to_value
 
Methods inherited from interface org.omg.DynamicAny.DynAnyOperations
assign, component_count, copy, current_component, destroy, equal, from_any, get_any, get_boolean, get_char, get_double, get_dyn_any, get_float, get_long, get_longlong, get_octet, get_reference, get_short, get_string, get_typecode, get_ulong, get_ulonglong, get_ushort, get_val, get_wchar, get_wstring, insert_any, insert_boolean, insert_char, insert_double, insert_dyn_any, insert_float, insert_long, insert_longlong, insert_octet, insert_reference, insert_short, insert_string, insert_typecode, insert_ulong, insert_ulonglong, insert_ushort, insert_val, insert_wchar, insert_wstring, next, rewind, seek, to_any, type
 

Method Detail

current_member_kind

TCKind current_member_kind()
                           throws TypeMismatch,
                                  InvalidValue
Get the kind of the current member.

Returns:
the kind of member at the current position.
Throws:
TypeMismatch - if this DynValue is holding null.
InvalidValue

current_member_name

String current_member_name()
                           throws TypeMismatch,
                                  InvalidValue
Get the name of the current member.

Returns:
the name of the current member as defined by the typecode. May be an empty string.
Throws:
TypeMismatch - if this DynValue is holding null.
InvalidValue

get_members_as_dyn_any

NameDynAnyPair[] get_members_as_dyn_any()
                                        throws InvalidValue
Get all members as an array of the named DynAny's. The returned names are set as they are defined by typecode.

Returns:
the array, representing the members of this instance of value.
Throws:
InvalidValue - if this DynValue is holding null.

get_members

NameValuePair[] get_members()
                            throws InvalidValue
Get all members as an array of the named Any's. The returned names are set as they are defined by typecode.

Returns:
the array, representing the members of this instance of value.
Throws:
InvalidValue - if this DynValue is holding null.

set_members_as_dyn_any

void set_members_as_dyn_any(NameDynAnyPair[] value)
                            throws TypeMismatch,
                                   InvalidValue
Set all members from the array of the named Any's.

Parameters:
value - the array, where the data for fields of the structure must occur exactly in the same order, as defined by typecode.
Throws:
TypeMismatch - if the type or name of the array member does not match the name and type of the corresponding field in the DynValue data structure. The empty string is assumed matching any name.
InvalidValue - if the size of the array does not match the number of fields.

set_members

void set_members(NameValuePair[] value)
                 throws TypeMismatch,
                        InvalidValue
Set all members from the array of the named Any's.

Parameters:
value - the array, where the data for fields of the structure must occur exactly in the same order, as defined by typecode.
Throws:
TypeMismatch - if the type or name of the array member does not match the name and type of the corresponding field in the DynValue data structure. The empty string is assumed matching any name.
InvalidValue - if the size of the array does not match the number of fields.