org.omg.DynamicAny
인터페이스 DynAnyOperations

알려진 서브 인터페이스 목록 :

DynAny, DynArray, DynArrayOperations, DynEnum, DynEnumOperations, DynFixed, DynFixedOperations, DynSequence, DynSequenceOperations, DynStruct, DynStructOperations, DynUnion, DynUnionOperations, DynValue, DynValueBox, DynValueBoxOperations, DynValueCommon, DynValueCommonOperations, DynValueOperations

알려진 구현 클래스 목록:

_DynAnyStub, _DynArrayStub, _DynEnumStub, _DynFixedStub, _DynSequenceStub, _DynStructStub, _DynUnionStub, _DynValueStub

public interface DynAnyOperations

Any 값은 DynAny 객체를 통해 동적으로 해석 (traversal) 및 구축할 수 있습니다. DynAny 객체는 any에 삽입되는 값의 카피에 대응하는 데이터에 관련지을 수 있습니다.

DynAny 객체는 컴퍼넌트의 DynAny 순서를 갖는 컬렉션이라고 볼 수가 있습니다. DynAny가 long 등의 기본형을 나타내는 경우, 또는 비어있는 예외와 같이 컴퍼넌트가 없는 형태를 나타내는 경우는 컴퍼넌트의 순서를 갖는 컬렉션은 비웁니다. 각각의 DynAny 객체로 그 DynAny 컴퍼넌트의 컬렉션내에 있어서의 현재 위값이 파악됩니다. 현재 위치는 0 으로부터 n-1 인덱스치로 나타납니다 (n는 컴퍼넌트의 수). -1 그렇다고 하는 특별한 인덱스치도 있어, 이것은 현재 위값이 어디도 지시하지 않은 것을의미합니다. 현재 위치를 가질 수 없는 값 (비어있는 예외등)의 경우, 인덱스치는 -1 으로 고정됩니다. DynAny가 컴퍼넌트를 가지는 값으로 초기화되었을 경우, 인덱스도 0에 초기화됩니다. 초기화되어 있지 않은 DynAny (DynAny에 값이 없지만, 컴퍼넌트를 가질 수 있는 TypeCode가 있다)가 작성되었을 경우는 현재 위치는 DynAny에 의해 나타내지는 값의 형태에 따라서 달라, 새로운 작성된 DynAny 컴퍼넌트가 기본값을 가질 수 있을지 어떨지에 의해 0 또는 -1 이 됩니다.

rewind, seek 및 next 반복 조작을 사용하면, 현재 위치를 변경할 수 있습니다. current_component 조작은 현재 위치의 컴퍼넌트를 리턴합니다. component_count 조작은 DynAny 컴퍼넌트의 수를 리턴합니다. 이러한 조작을 아울러 사용하면, 컴퍼넌트의 내용을 (재귀적으로) 조사하는 등, DynAny 컴퍼넌트에 대해서 반복 처리를 실시할 수 있습니다.

구축형과 관련된 DynAny 객체를, 구축형 DynAny 객체라고 합니다. IDL 각종 구축형 (fixed, enum, struct, sequence, union, array, exception, 치 형)의 각각 붙어, DynAny 인터페이스로부터 상속된 인터페이스가 있습니다.

구축형 DynAny 객체는 DynAny 객체를 새로운 작성하기 위한 조작을 export 합니다. 작성되는 객체는 각각 구축형의 데이터의 컴퍼넌트에 관련지을 수 있습니다. 예를 들어 DynStruct는 struct 치와 관련지을 수 있습니다. 즉, DynStruct는 구조체의 멤버 마다 컴퍼넌트가 1개 씩 있는 것 같은 순서를 갖는 컬렉션을 소유한다고 볼 수가 있습니다. DynStruct 객체는 struct 멤버에 관련된 DynAny 객체를 새로운 작성하기 위한 조작을 export 합니다.

다른 (구축형) DynAny 로부터 DynAny 객체를 얻었을 경우, 예를 들어 DynStruct 로부터 작성된, 구조체 멤버를 나타내는 DynAny는 DynStruct에 논리적으로 포함되게 됩니다. insert 또는 get 조작을 호출해도, 현재 위치는 변경되지 않습니다. 최상정도의 DynAny 객체 (다른 DynAny 컴퍼넌트는 아닌 것)를 파기하면, 그 컴퍼넌트의 DynAny도 파기됩니다. 최상정도가 아닌 DynAny를 파기했을 경우는 아무것도 일어나지 않습니다. 파기된 최상정도의 DynAny, 또는 그 하위 객체에 대해서 조작을 호출하면, OBJECT_NOT_EXIST가 발생 됩니다. DynAny를 파기한 뒤도, 거기에 관련된 데이터의 컴퍼넌트를 조작하려면, 우선 컴퍼넌트의 DynAny를 작성하고 나서, 작성한 DynAny 객체의 복사본을 작성합니다.

DynAny 객체의 동작은 할당할 수 있었던 메모리 공간과 액세스 속도에 관해서 효과적인 구현을 실현할 수 있도록 정의되고 있습니다. DynAny 객체는 실행시에 any 로부터 추출된 값의 traversal이나, any 값의 구축을 실시하기 위해서 사용하는 것이 상정되고 있습니다. 다른 용도에서의 사용은 추천하지 않습니다.

insert와 get 각 조작은 기본 DynAny 객체의 조작에 필요합니다만, 구축형 DynAny 객체의 조작에도 도움이 됩니다. 구축형 DynAny 객체에 기본 데이터형의 값을 삽입하면, DynAny 객체에 관련된 구축형 데이터의 현재의 컴퍼넌트를 초기화하게 됩니다. 예를 들어 DynStruct 로 insert_boolean를 호출하면, 관련된 struct 데이터의 현재 위치에 boolean 데이터가 삽입됩니다. 값의 TypeCode가 DynAny에 포함되는 TypeCode와 같은 경우, 값의 삽입과 추출을 통해 형태는 같게 됩니다. DynAny에 컴퍼넌트가 있는 경우는 값의 삽입과 추출에 있어서의 형태는 현재 위치의 DynAny TypeCode와 같게 됩니다.

DynAny 객체와 DynAnyFactory 객체는 그것들이 작성 및 사용되는 프로세스에 대해서 로컬이라고 상정되고 있습니다. 즉, DynAny 및 DynAnyFactory 객체에의 참조를 다른 프로세스에 export 하거나 ORB.object_to_string()로 외부화하거나 하지 못하고, 실행을 시도하면 MARSHAL 시스템 예외가 발생합니다. IDL에 인터페이스가 지정되고 있기 때문에 DynAny 객체에서는 표준의 org.omg.CORBA.Object 인터페이스에 정의되고 있는 조작을 export 할 수 있습니다. 다만, Object 인터페이스를 통해 export 한 조작을 호출하려고 하면, 표준 NO_IMPLEMENT 예외가 발생하는 일이 있습니다. DynAny 객체를 DII와 사용하려고 하면, NO_IMPLEMENT 예외가 발생하는 경우가 있습니다.

메서드 개요

void	assign (DynAny dyn_any) DynAny 객체에 관련된 값을 다른 DynAny 객체에 관련된 값으로 초기화합니다.
int	component_count () DynAny 컴퍼넌트의 수를 리턴합니다.
DynAny	copy () 호출한 DynAny 딥 복사인 값을 가지는 DynAny를 새로운 작성합니다.
DynAny	current_component () 현재 위치의 컴퍼넌트의 DynAny를 리턴합니다.
void	destroy () DynAny 객체를 파기합니다.
boolean	equal (DynAny dyn_any) 2개의 DynAny 값이 동일한지 어떤지 비교합니다.
void	from_any (Any value) DynAny 객체에 관련된 값을 any에 포함되는 값으로 초기화합니다.
Any	get_any () 이 DynAny가 나타내는 Any에 포함되어 있는 Any 치를 추출합니다.
boolean	get_boolean () 이 DynAny 로부터 boolean 치를 추출합니다.
char	get_char () 이 DynAny 로부터 char값을 추출합니다.
double	get_double () 이 DynAny 로부터 double값을 추출합니다.
DynAny	get_dyn_any () 이 DynAny가 나타내는 Any에 포함되어 있는 Any 치를 추출해, 그것을 새로운 DynAny에 랩의해 리턴합니다.
float	get_float () 이 DynAny 로부터 float값을 추출합니다.
int	get_long () 이 DynAny 로부터 정수값을 추출합니다.
long	get_longlong () 이 DynAny 로부터 long값을 추출합니다.
byte	get_octet () 이 DynAny 로부터 byte값을 추출합니다.
Object	get_reference () 이 DynAny 로부터 CORBA 객체에의 참조를 추출합니다.
short	get_short () 이 DynAny 로부터 short값을 추출합니다.
String	get_string () 이 DynAny 로부터 캐릭터 라인치를 추출합니다.
TypeCode	get_typecode () 이 DynAny 로부터 TypeCode 객체를 추출합니다.
int	get_ulong () 이 DynAny 로부터 정수값을 추출합니다.
long	get_ulonglong () 이 DynAny 로부터 long값을 추출합니다.
short	get_ushort () 이 DynAny 로부터 short값을 추출합니다.
Serializable	get_val () 이 DynAny 로부터 직렬화 가능 객체를 추출합니다.
char	get_wchar () 이 DynAny 로부터 long값을 추출합니다.
String	get_wstring () 이 DynAny 로부터 캐릭터 라인치를 추출합니다.
void	insert_any (Any value) 이 DynAny가 나타내는 Any에 Any 치를 삽입합니다.
void	insert_boolean (boolean value) DynAny에 boolean 치를 삽입합니다.
void	insert_char (char value) DynAny에 char값을 삽입합니다.
void	insert_double (double value) DynAny에 double값을 삽입합니다.
void	insert_dyn_any (DynAny value) 이 DynAny가 나타내는 Any 에 파라미터 DynAny 내의 Any 치를 삽입합니다.
void	insert_float (float value) DynAny에 float값을 삽입합니다.
void	insert_long (int value) DynAny에 정수값을 삽입합니다.
void	insert_longlong (long value) DynAny에 long값을 삽입합니다.
void	insert_octet (byte value) DynAny에 byte값을 삽입합니다.
void	insert_reference (Object value) DynAny에 CORBA 객체에의 참조를 삽입합니다.
void	insert_short (short value) DynAny에 short값을 삽입합니다.
void	insert_string (String value) DynAny에 캐릭터 라인치를 삽입합니다.
void	insert_typecode (TypeCode value) DynAny에 TypeCode 객체를 삽입합니다.
void	insert_ulong (int value) DynAny에 정수값을 삽입합니다.
void	insert_ulonglong (long value) DynAny에 long값을 삽입합니다.
void	insert_ushort (short value) DynAny에 short값을 삽입합니다.
void	insert_val (Serializable value) 이 DynAny에 직렬화 가능 객체에 대한 참조를 삽입합니다.
void	insert_wchar (char value) DynAny에 char값을 삽입합니다.
void	insert_wstring (String value) DynAny에 캐릭터 라인치를 삽입합니다.
boolean	next () 현재 위치를 다음의 컴퍼넌트에 진행합니다.
void	rewind () seek(0)와 같습니다.
boolean	seek (int index) 현재 위치를 index 로 설정합니다.
Any	to_any () DynAny 객체로부터 any 치를 작성합니다.
TypeCode	type () 이 DynAny 객체에 관련된 TypeCode를 리턴합니다.

메서드의 상세

type

TypeCode  type()

이 DynAny 객체에 관련된 TypeCode를 리턴합니다. DynAny 객체는 작성시에 TypeCode 치를 할당할 수 있습니다. 이 TypeCode 값에의해 DynAny 객체를 통해 다루어지는 값의 형태가 정해집니다. DynAny 객체에 관련된 TypeCode는 DynAny 작성시에 초기화되어 그 DynAny 존속 기간중은 변경할 수 없는 것에 주의해 주세요.

반환값:

이 DynAny 객체에 관련된 TypeCode

assign

void assign(DynAny  dyn_any)
            throws TypeMismatch 

DynAny 객체에 관련된 값을 다른 DynAny 객체에 관련된 값으로 초기화합니다. 초기화되는 DynAny 현재 위치는 값이 컴퍼넌트를 가지는 경우는 0 에 컴퍼넌트를 가지지 않는 경우는 -1 으로 설정됩니다.

파라미터:

dyn_any - @exception TypeMismatch 건네받은 DynAny 형태가 초기화되는 DynAny 형태에 일치하지 않는 경우

예외:

TypeMismatch

from_any

void from_any(Any  value)
              throws TypeMismatch,

                     InvalidValue 

DynAny 객체에 관련된 값을 any에 포함되는 값으로 초기화합니다. 초기화되는 DynAny 현재 위치는 값이 컴퍼넌트를 가지는 경우는 0 에 컴퍼넌트를 가지지 않는 경우는 -1 으로 설정됩니다.

예외:

TypeMismatch - 건네받은 Any 형태가 초기화되는 DynAny 형태에 일치하지 않는 경우

InvalidValue - 건네받은 Any에 정당한 값이 포함되지 않는 경우 (null 캐릭터 라인 등)

to_any

Any  to_any()

DynAny 객체로부터 any 치를 작성합니다. DynAny 객체에 관련된 TypeCode 카피가 결과적으로 작성되는 any에 할당할 수 있습니다. DynAny 객체에 관련된 값이 any에 복사됩니다.

반환값:

같은 값과 TypeCode를 가지는 Any 객체

equal

boolean equal(DynAny  dyn_any)

2개의 DynAny 값이 동일한지 어떤지 비교합니다. DynAny 치는 TypeCode가 동일하고, 재귀적으로 모든 DynAny가 동일한 값을 가지는 경우에 동일하게 됩니다. 비교 대상의 2개의 DynAny 현재 위치는 동일한지 어떤지에는 관계하지 않습니다.

반환값:

2개의 DynAny가 동일한 경우는 true, 그렇지 않은 경우는 false

destroy

void destroy()

DynAny 객체를 파기합니다. 이 조작에의해 DynAny 객체에 관련된 데이터를 나타내기 위해서 사용되는 자원은 모두 해방됩니다. ORB 인터페이스의 작성 조작으로 취득한 참조나, DynAny.copy()로부터 리턴된 참조에 대해서는 반드시 호출해, 자원의 리크를 막을 필요가 있습니다. 컴퍼넌트의 DynAny 객체 (예를 들어 current_component 조작으로 리턴된 객체등)로 파기 조작을 호출해도 아무것도 일어나지 않습니다. DynAny 객체를 파기하면, 그 객체로부터 얻을 수 있는 모든 DynAny 객체가 파기되게 됩니다. 즉, 파기된 DynAny 컴퍼넌트에의 참조는 무효가 됩니다. 이러한 참조로 호출을 실시하면, OBJECT_NOT_EXIST가 발생합니다. DynAny 컴퍼넌트를 그 DynAny 파기 후도 조작하려면, DynAny를 파기하기 전에 카피 조작으로 컴퍼넌트의 복사본을 작성합니다.

copy

DynAny  copy()

호출한 DynAny 딥 복사인 값을 가지는 DynAny를 새로운 작성합니다. 이 조작은 다양형입니다. 즉, DynAny 로부터 파생한 DynStruct 등의 형태로 호출하면, 파생형이 작성됩니다만, 참조는 기저형의 DynAny 로 리턴됩니다 .

반환값:

DynAny 객체의 딥 카피

insert_boolean

void insert_boolean(boolean value)
                    throws TypeMismatch,

                           InvalidValue 

DynAny에 boolean 치를 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_octet

void insert_octet(byte value)
                  throws TypeMismatch,

                         InvalidValue 

DynAny에 byte값을 삽입합니다. IDL 데이터형 octet는 Java 데이터형 byte에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_char

void insert_char(char value)
                 throws TypeMismatch,

                        InvalidValue 

DynAny에 char값을 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_short

void insert_short(short value)
                  throws TypeMismatch,

                         InvalidValue 

DynAny에 short값을 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_ushort

void insert_ushort(short value)
                   throws TypeMismatch,

                          InvalidValue 

DynAny에 short값을 삽입합니다. IDL 데이터형 ushort는 Java 데이터형 short에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_long

void insert_long(int value)
                 throws TypeMismatch,

                        InvalidValue 

DynAny에 정수값을 삽입합니다. IDL 데이터형 long는 Java 데이터형 int에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_ulong

void insert_ulong(int value)
                  throws TypeMismatch,

                         InvalidValue 

DynAny에 정수값을 삽입합니다. IDL 데이터형 ulong는 Java 데이터형 int에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_float

void insert_float(float value)
                  throws TypeMismatch,

                         InvalidValue 

DynAny에 float값을 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_double

void insert_double(double value)
                   throws TypeMismatch,

                          InvalidValue 

DynAny에 double값을 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_string

void insert_string(String  value)
                   throws TypeMismatch,

                          InvalidValue 

DynAny에 캐릭터 라인치를 삽입합니다. 바운드 형식과 안 바운드 형식의 어느 쪽의 캐릭터 라인의 경우도 이 메서드를 사용해 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

InvalidValue - 삽입되는 캐릭터 라인이 바운드 형식의 캐릭터 라인의 경계보다 긴 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_reference

void insert_reference(Object  value)
                      throws TypeMismatch,

                             InvalidValue 

DynAny에 CORBA 객체에의 참조를 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_typecode

void insert_typecode(TypeCode  value)
                     throws TypeMismatch,

                            InvalidValue 

DynAny에 TypeCode 객체를 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_longlong

void insert_longlong(long value)
                     throws TypeMismatch,

                            InvalidValue 

DynAny에 long값을 삽입합니다. IDL 데이터형 long long는 Java 데이터형 long에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_ulonglong

void insert_ulonglong(long value)
                      throws TypeMismatch,

                             InvalidValue 

DynAny에 long값을 삽입합니다. IDL 데이터형의 부호 없음 long long는 Java 데이터형 long에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_wchar

void insert_wchar(char value)
                  throws TypeMismatch,

                         InvalidValue 

DynAny에 char값을 삽입합니다. IDL 데이터형 wchar는 Java 데이터형 char에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_wstring

void insert_wstring(String  value)
                    throws TypeMismatch,

                           InvalidValue 

DynAny에 캐릭터 라인치를 삽입합니다. 바운드 형식과 안 바운드 형식의 어느 쪽의 캐릭터 라인의 경우도 이 메서드를 사용해 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

InvalidValue - 삽입되는 캐릭터 라인이 바운드 형식의 캐릭터 라인의 경계보다 긴 경우

TypeMismatch

insert_any

void insert_any(Any  value)
                throws TypeMismatch,

                       InvalidValue 

이 DynAny가 나타내는 Any에 Any 치를 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_dyn_any

void insert_dyn_any(DynAny  value)
                    throws TypeMismatch,

                           InvalidValue 

이 DynAny가 나타내는 Any 에 파라미터 DynAny 내의 Any 치를 삽입합니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

insert_val

void insert_val(Serializable  value)
                throws TypeMismatch,

                       InvalidValue 

이 DynAny에 직렬화 가능 객체에 대한 참조를 삽입합니다. IDL ValueBase 형은 Java Serializable 형에 맵 됩니다.

예외:

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

get_boolean

boolean get_boolean()
                    throws TypeMismatch,

                           InvalidValue 

이 DynAny 로부터 boolean 치를 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_octet

byte get_octet()
               throws TypeMismatch,

                      InvalidValue 

이 DynAny 로부터 byte값을 추출합니다. IDL 데이터형 octet는 Java 데이터형 byte에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_char

char get_char()
              throws TypeMismatch,

                     InvalidValue 

이 DynAny 로부터 char값을 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_short

short get_short()
                throws TypeMismatch,

                       InvalidValue 

이 DynAny 로부터 short값을 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_ushort

short get_ushort()
                 throws TypeMismatch,

                        InvalidValue 

이 DynAny 로부터 short값을 추출합니다. IDL 데이터형 ushort는 Java 데이터형 short에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_long

int get_long()
             throws TypeMismatch,

                    InvalidValue 

이 DynAny 로부터 정수값을 추출합니다. IDL 데이터형 long는 Java 데이터형 int에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_ulong

int get_ulong()
              throws TypeMismatch,

                     InvalidValue 

이 DynAny 로부터 정수값을 추출합니다. IDL 데이터형 ulong는 Java 데이터형 int에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_float

float get_float()
                throws TypeMismatch,

                       InvalidValue 

이 DynAny 로부터 float값을 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_double

double get_double()
                  throws TypeMismatch,

                         InvalidValue 

이 DynAny 로부터 double값을 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_string

String  get_string()
                  throws TypeMismatch,

                         InvalidValue 

이 DynAny 로부터 캐릭터 라인치를 추출합니다. 바운드 형식과 안 바운드 형식의 어느 쪽의 캐릭터 라인의 경우도 이 메서드를 사용해 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_reference

Object  get_reference()
                     throws TypeMismatch,

                            InvalidValue 

이 DynAny 로부터 CORBA 객체에의 참조를 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_typecode

TypeCode  get_typecode()
                      throws TypeMismatch,

                             InvalidValue 

이 DynAny 로부터 TypeCode 객체를 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_longlong

long get_longlong()
                  throws TypeMismatch,

                         InvalidValue 

이 DynAny 로부터 long값을 추출합니다. IDL 데이터형 long long는 Java 데이터형 long에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_ulonglong

long get_ulonglong()
                   throws TypeMismatch,

                          InvalidValue 

이 DynAny 로부터 long값을 추출합니다. IDL 데이터형의 부호 없음 long long는 Java 데이터형 long에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_wchar

char get_wchar()
               throws TypeMismatch,

                      InvalidValue 

이 DynAny 로부터 long값을 추출합니다. IDL 데이터형 wchar는 Java 데이터형 char에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_wstring

String  get_wstring()
                   throws TypeMismatch,

                          InvalidValue 

이 DynAny 로부터 캐릭터 라인치를 추출합니다. 바운드 형식과 안 바운드 형식의 어느 쪽의 캐릭터 라인의 경우도 이 메서드를 사용해 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue

get_any

Any  get_any()
            throws TypeMismatch,

                   InvalidValue 

이 DynAny가 나타내는 Any에 포함되어 있는 Any 치를 추출합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_dyn_any

DynAny  get_dyn_any()
                   throws TypeMismatch,

                          InvalidValue 

이 DynAny가 나타내는 Any에 포함되어 있는 Any 치를 추출해, 그것을 새로운 DynAny에 랩의해 리턴합니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

get_val

Serializable  get_val()
                     throws TypeMismatch,

                            InvalidValue 

이 DynAny 로부터 직렬화 가능 객체를 추출합니다. IDL ValueBase 형은 Java Serializable 형에 맵 됩니다.

예외:

TypeMismatch - DynAny 액세스 대상의 컴퍼넌트가 요구된 형태와 같은 형태가 아닌 경우

TypeMismatch - 현재의 컴퍼넌트 자체가 컴퍼넌트를 가지는 것 같은 DynAny 로 불려 갔을 경우

InvalidValue - 이 DynAny가 컴퍼넌트를 가지지만, 현재 위값이 -1 인 경우

seek

boolean seek(int index)

현재 위치를 index 로 설정합니다. 현재 위치에는 0 으로부터 n-1 라고 하는 인덱스가 붙습니다. 즉, 0 이라고 하는 인덱스는 최초의 컴퍼넌트에 대응합니다. 이 조작은 결과의 현재 위값이 DynAny 컴퍼넌트를 나타내는 경우는 true, 컴퍼넌트에 대응하지 않는 위치를 나타내는 경우는 false를 리턴합니다. seek는 부의 인덱스에서도 호출할 수 있습니다. 이 경우 현재 위치는 -1 으로 설정되어 어느 컴퍼넌트도 지시하지 않게 되어, false가 리턴됩니다 . 현재 위치에 컴퍼넌트가 없는 DynAny에 대해 부 이외의 인덱스치를 건네주면, 현재 위값이 -1 로 설정되어 false가 리턴됩니다 .

rewind

void rewind()

seek(0)와 같습니다.

next

boolean next()

현재 위치를 다음의 컴퍼넌트에 진행합니다. 조작은 결과의 현재 위값이 컴퍼넌트를 나타내는 경우는 true, 그렇지 않은 경우는 false를 리턴합니다. false가 돌려주고졌을 경우, 현재 위치는 -1 대로 됩니다. 컴퍼넌트를 가지지 않는 DynAny 로 next를 호출하면, 현재 위치는 -1 인 채로 false가 리턴됩니다 .

component_count

int component_count()

DynAny 컴퍼넌트의 수를 리턴합니다. DynAny가 컴퍼넌트를 가지지 않는 경우는 0을 리턴합니다. 컴퍼넌트수의 카운트는 최상정도인 만큼 대해 행해집니다. 예를 들어 멤버가 1개 밖에 없는 DynStruct 로 component_count를 호출하면, 그것이 어떠한 멤버여도 반환값은 1 이 됩니다.

• 순서의 경우, 이 조작은 현재의 요소수를 리턴합니다.
• 구조체, 예외 및 치 형의 경우, 이 조작은 멤버의 수를 리턴합니다.
• 배열의 경우, 이 조작은 요소수를 리턴합니다.
• 공용체의 경우, 지정된 멤버가 활성화되었다 라고 판별자가 가리키는 경우는 2, 그렇지 않은 경우는 1을 리턴합니다.
• DynFixed 및 DynEnum인 경우, 이 조작은 0을 리턴합니다.

current_component

DynAny  current_component()
                         throws TypeMismatch 

현재 위치의 컴퍼넌트의 DynAny를 리턴합니다. 현재 위치는 진행하지 않기 때문에 rewind, next, seek 어떤 것인지를 호출하지 않고 current_component를 반복해 호출하면, 같은 컴퍼넌트가 돌려주고지게 됩니다. 리턴된 DynAny 객체 참조는 현재의 컴퍼넌트의 값의 취득이나 설정에 사용할 수 있습니다. 현재의 컴퍼넌트가 복합형을 나타내는 경우, 리턴된 참조를 TypeCode에 근거해 네로우 변환해, 그 복합형에 대응하는 인터페이스를 취득할 수 있습니다. DynEnum 또는 비어있는 예외와 같이 컴퍼넌트를 가질 수 없는 DynAny 로 current_component를 호출하면, TypeMismatch가 발생합니다. 현재 위값이 -1 인 DynAny 로 current_component를 호출하면, nil 참조가 리턴됩니다 . current_component와 함께 반복해 조작을 사용하면, any 치를 동적으로 작성할 수 있습니다. DynStruct 등이 동적인 any를 작성 후, current_component와 next를 사용해, 값의 모든 컴퍼넌트를 초기화할 수 있습니다. 동적인 값이 완전하게 초기화되면, 대응하는 any 치를 to_any 로 작성할 수 있습니다.

예외:

TypeMismatch - DynEnum 나 비어있는 예외와 같이 컴퍼넌트를 가질 수 없는 DynAny 로 불려 갔을 경우