org.omg.DynamicAny
인터페이스 DynValueOperations

모든 슈퍼 인터페이스:

DynAnyOperations , DynValueCommonOperations

기존의 서브 인터페이스의 일람:

DynValue

기존의 구현 클래스의 일람:

_DynValueStub

public interface DynValueOperations
extends DynValueCommonOperations 

DynValue 객체에 의해, IDL 의 비 boxed 치 형의 조작이 지원됩니다. DynValue 인터페이스는, null 와 null 이외의 양쪽 모두의 치 형을 나타낼 수가 있습니다. null 이외의 치 형을 나타내는 DynValue 의 경우, DynValue 의 컴퍼넌트에는 치 형의 public 및 private 멤버가, 구상 기저형으로부터 상속된 것도 포함해, 정의순서에 포함됩니다. null 의 치 형을 나타내는 DynValue 에는 컴퍼넌트는 없고, 현재 위치는 -1 이 됩니다.

경고:치 형이 private 의 멤버의 내용을 함부로 변경하면(자), 내부 제약 위반에 의해 치 형의 구현이 손상하는 원인이 되는 경우가 있습니다. private 멤버에게로의 액세스는, ORB 의 브릿지나 디버그등의 활동을 지원하기 위해서 준비되어 있어서 , 치 형의 캡슐화에 독단으로 위반하기 위해서(때문에) 사용해야 하지는 않습니다.

메소드의 개요

TCKind	current_member_kind () 현재 위치의 멤버가 관련지을 수 있었던 TCKind 를 돌려줍니다.
String	current_member_name () 현재 위치의 멤버의 이름을 돌려줍니다.
NameDynAnyPair []	get_members_as_dyn_any () 치 형의 각 멤버의 이름과 값을 나타내는 NameDynAnyPair 의 순서를 돌려줍니다.
NameValuePair []	get_members () 치 형의 각 멤버의 이름과 값을 나타내는 NameValuePair 의 순서를 돌려줍니다.
void	set_members_as_dyn_any (NameDynAnyPair [] value) 치 형의 멤버를, NameDynAnyPair 의 순서로 초기화합니다.
void	set_members (NameValuePair [] value) 치 형의 멤버를, NameValuePair 의 순서로 초기화합니다.

인터페이스 org.omg.DynamicAny. DynValueCommonOperations 로부터 상속된 메소드

is_null , set_to_null , set_to_value

인터페이스 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

메소드의 상세

current_member_name

String  current_member_name()
                           throws TypeMismatch ,
                                  InvalidValue 

현재 위치의 멤버의 이름을 돌려줍니다. 조작 대상의 값의 TypeCode 에는 멤버의 이름이 포함되지 않는 것도 있기 (위해)때문에, 빈 상태(empty)의 캐릭터 라인이 반환되는 경우도 있습니다.

예외:

TypeMismatch - DynValue 가 null 의 치 형을 나타내는 경우

InvalidValue - 현재 위치가 멤버를 지시하지 않는 경우

current_member_kind

TCKind  current_member_kind()
                           throws TypeMismatch ,
                                  InvalidValue 

현재 위치의 멤버가 관련지을 수 있었던 TCKind 를 돌려줍니다.

예외:

TypeMismatch - DynValue 가 null 의 치 형을 나타내는 경우

InvalidValue - 현재 위치가 멤버를 지시하지 않는 경우

get_members

NameValuePair [] get_members()
                            throws InvalidValue 

치 형의 각 멤버의 이름과 값을 나타내는 NameValuePair 의 순서를 돌려줍니다. 이 순서에는, DynValue 의 TypeCode 에 의해 나타나는 멤버의 선언순서에 멤버가 포함됩니다. 현재 위치는 변경되지 않습니다. DynValue 의 TypeCode 에 멤버명이 포함되지 않는 경우는, 반환되는 순서내의 멤버명은 비웁니다.

예외:

InvalidValue - 이 객체가 null 의 치 형을 나타내는 경우

set_members

void set_members(NameValuePair [] value)
                 throws TypeMismatch ,
                        InvalidValue 

치 형의 멤버를, NameValuePair 의 순서로 초기화합니다. 건네받는 순서의 길이가 0 이외인 경우, 현재 위치는 0 으로 설정됩니다. 그렇지 않는 경우, 즉 빈 상태(empty)의 순서가 건네받으면(자), 현재 위치는 -1 으로 설정됩니다. 이 메소드를 사용해, null 의 치 형을 null 이외의 치 형에 초기화할 수가 있습니다.

NameValuePair 의 멤버의 순서는, DynValue 의 TypeCode 에 나타나는 치 형의 IDL 지정과 같은 순서일 필요가 있습니다. 그렇지 않은 경우는 빈 상태(empty)의 캐릭터 라인이 아니면 안됩니다. 이 오퍼레이션에서는, 멤버명에 근거해 멤버의 값을 할당할 수 있을 것은 없습니다.

예외:

TypeMismatch - 건네받은 순서로 지정된 멤버명이, DynValue 의 TypeCode 의 대응하는 멤버명에 일치하지 않고, 빈 상태(empty)의 캐릭터 라인도 아닌 경우

InvalidValue - 건네받은 순서의 요소의 수가, DynValue 의 TypeCode 의 멤버의 수로 일치하지 않는 경우

get_members_as_dyn_any

NameDynAnyPair [] get_members_as_dyn_any()
                                        throws InvalidValue 

치 형의 각 멤버의 이름과 값을 나타내는 NameDynAnyPair 의 순서를 돌려줍니다. 이 순서에는, DynValue 의 TypeCode 에 의해 나타나는 멤버의 선언순서에 멤버가 포함됩니다. 현재 위치는 변경되지 않습니다. DynValue 의 TypeCode 에 멤버명이 포함되지 않는 경우는, 반환되는 순서내의 멤버명은 비웁니다.

예외:

InvalidValue - 이 객체가 null 의 치 형을 나타내는 경우

set_members_as_dyn_any

void set_members_as_dyn_any(NameDynAnyPair [] value)
                            throws TypeMismatch ,
                                   InvalidValue 

치 형의 멤버를, NameDynAnyPair 의 순서로 초기화합니다. 건네받는 순서의 길이가 0 이외인 경우, 현재 위치는 0 으로 설정됩니다. 그렇지 않는 경우, 즉 빈 상태(empty)의 순서가 건네받으면(자), 현재 위치는 -1 으로 설정됩니다. 이 메소드를 사용해, null 의 치 형을 null 이외의 치 형에 초기화할 수가 있습니다.

NameDynAnyPair 의 멤버의 순서는, DynValue 의 TypeCode 에 나타나는 치 형의 IDL 지정과 같은 순서일 필요가 있습니다. 그렇지 않은 경우는 빈 상태(empty)의 캐릭터 라인이 아니면 안됩니다. 이 오퍼레이션에서는, 멤버명에 근거해 멤버의 값을 할당할 수 있을 것은 없습니다.

예외:

TypeMismatch - 건네받은 순서로 지정된 멤버명이, DynValue 의 TypeCode 의 대응하는 멤버명에 일치하지 않고, 빈 상태(empty)의 캐릭터 라인도 아닌 경우

InvalidValue - 건네받은 순서의 요소의 수가, DynValue 의 TypeCode 의 멤버의 수로 일치하지 않는 경우