org.omg.DynamicAny
클래스 DynAnyHelper

java.lang.Object 
  org.omg.DynamicAny.DynAnyHelper

public abstract class DynAnyHelper
extends Object 

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 예외가 발생하는 경우가 있습니다.

생성자 개요

DynAnyHelper ()

메서드 개요

static DynAny	extract (Any a)
static String	id ()
static void	insert (Any a, DynAny that)
static DynAny	narrow (Object obj)
static DynAny	read (InputStream istream)
static TypeCode	type ()
static DynAny	unchecked_narrow (Object obj)
static void	write (OutputStream ostream, DynAny value)

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

DynAnyHelper

public DynAnyHelper()

메서드의 상세

insert

public static void insert(Any  a,
                          DynAny  that)

extract

public static DynAny  extract(Any  a)

type

public static TypeCode  type()

id

public static String  id()

read

public static DynAny  read(InputStream  istream)

write

public static void write(OutputStream  ostream,
                         DynAny  value)

narrow

public static DynAny  narrow(Object  obj)

unchecked_narrow

public static DynAny  unchecked_narrow(Object  obj)