org.omg.DynamicAny
인터페이스 DynAnyFactoryOperations

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

DynAnyFactory

알려진 구현 클래스 목록:

_DynAnyFactoryStub

public interface DynAnyFactoryOperations

DynAny 객체는 DynAnyFactory 객체로 오퍼레이션을 호출하는 것으로 작성할 수 있습니다. 일반적으로 DynAny 객체를 작성하는 방법은 2개 있습니다.

• 기존의 DynAny 객체로 오퍼레이션을 호출한다
• DynAnyFactory 객체로 오퍼레이션을 호출한다

구축형 DynAny 객체에서는 원가요소의 값에의 액세스를 캡슐화하는 것 같은 DynAny 객체를 새롭게 작성할 수 있는 오퍼레이션이 지원 됩니다. DynAny 객체에서는 카피 오퍼레이션에 한 DynAny 객체의 새로운 작성도 지원 하고 있습니다. DynAnyFactory 객체에의 참조를 취득하려면, ORB.resolve_initial_references()를 호출합니다. 이 때, 식별자 파라미터를 「DynAnyFactory」라고 하는 캐릭터 라인 정수로 설정합니다.

보통, any 동적 해석에서는 최초로 create_dyn_any()를 사용해 DynAny 객체를 작성합니다. 작성되는 DynAny 객체 참조는 any 형태에의해 DynFixed, DynStruct, DynSequence, DynArray, DynUnion, DynEnum, 또는 DynValue 라고 하는 객체 참조에 네로우 변환할 수 있습니다.

any 동적 작성에서는 create_dyn_any_from_type_code()를 사용해 DynAny 객체를 작성합니다. 이 때, 작성하는 값에 관련짓는 TypeCode를 건네줍니다. 리턴된 참조는 필요에 따라서 DynStruct 등이 복잡한 형태의 어떤 것인가에 네로우 변환할 수 있습니다. 다음에 결과의 객체로 오퍼레이션을 호출해 값을 초기화합니다. 마지막으로 to_any 오퍼레이션을 시작해, 구축형 DynAny 로부터 값을 작성합니다.

메서드 개요

DynAny	create_dyn_any_from_type_code (TypeCode type) TypeCode 로부터 DynAny를 작성합니다.
DynAny	create_dyn_any (Any value) any 치로부터 DynAny 객체를 새로운 작성합니다.

메서드의 상세

create_dyn_any

DynAny  create_dyn_any(Any  value)
                      throws InconsistentTypeCode 

any 치로부터 DynAny 객체를 새로운 작성합니다. any 치에 관련된 TypeCode 카피가 결과적으로 작성되는 DynAny 객체에 할당할 수 있습니다. DynAny 객체에 관련된 값은 원의 any 값의 카피가 됩니다. 작성된 DynAny 현재 위치는 건네받은 값에 컴퍼넌트가 있는 경우는 0, 그 외의 경우는 -1 으로 설정됩니다.

예외:

InconsistentTypeCode - 치의 TypeCode가 TCKind of tk_Principal, tk_native, 또는 tk_abstract_interface 인 경우

create_dyn_any_from_type_code

DynAny  create_dyn_any_from_type_code(TypeCode  type)
                                     throws InconsistentTypeCode 

TypeCode 로부터 DynAny를 작성합니다. TypeCode 에의해 작성되는 객체의 형태는 DynAny 또는 그리고 파생한 DynStruct 등의 형태의 어떤 것인가가 됩니다. 리턴된 참조는 파생형에 네로우 변환할 수 있습니다. 어느 경우도, TypeCode 로부터 작성된 DynAny에는 기본값이 있습니다. 기본형의 기본값는 다음과 같이 됩니다.

• boolean인 경우는 false
• 수치형의 경우는 0
• octet, char 및 wchar인 경우는 0
• string와 wstring인 경우는 비어있는 캐릭터 라인
• 객체 참조의 경우는 null
• 형태 코드의 경우는 TCKind 값이 tk_null 인 형태 코드
• any 치의 경우는 TCKind 값이 tk_null 인 형태 코드를 가져, 값을 가지지 않는 any

복합형의 경우는 대응하는 DynAny를 작성하면, 다음과 같은 기본값을 할당할 수 있습니다.

• DynSequence인 경우, 현재 위값이 -1 로 설정되어 비어있는 순서가 작성된다
• DynEnum인 경우, 현재 위값이 -1 로 설정되어 열거자의 값은 TypeCode에 의해 나타나는 최초의 열거자의 값으로 설정된다
• DynFixed인 경우, 현재 위값이 -1 로 설정되어 값 0 이 설정된다
• DynStruct인 경우, 비어있는 예외에서는 현재 위값이 -1 에 그 이외의 TypeCode 에서는 현재 위값이 0 으로 설정된다. 멤버가 있으면, 그 기본값에 (재귀적으로) 초기화된다
• DynArray인 경우, 현재 위값이 0 으로 설정되어 요소가 기본값에 (재귀적으로) 초기화된다
• DynUnion인 경우, 현재 위값이 0 으로 설정된다. 판별자의 값은 공용체로 최초로 지정된 멤버에 일치하는 값으로 설정된다. 이 멤버는 액티브화 되어(재귀적으로) 기본값에 초기화된다
• DynValue 및 DynValueBox인 경우, null 치에 초기화된다

예외:

InconsistentTypeCode