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 の現在位置は、渡された値にコンポーネントがある場合はゼロ、それ以外の場合は -1 に設定されます。

例外:

InconsistentTypeCode - 値の TypeCode が TCKind の 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
• 数値型の場合はゼロ
• octet、char、および wchar の場合はゼロ
• string と wstring の場合は空の文字列
• オブジェクト参照の場合は null
• 型コードの場合は TCKind の値が tk_null である型コード
• any 値の場合は、TCKind の値が tk_null である型コードを持ち、値を持たない any

複合型の場合は、対応する DynAny を作成すると、次のようなデフォルト値が割り当てられます。

• DynSequence の場合、現在位置が -1 に設定され、空のシーケンスが作成される。
• DynEnum の場合、現在位置が -1 に設定され、列挙子の値は TypeCode によって示される最初の列挙子の値に設定される。
• DynFixed の場合、現在位置が -1 に設定され、値ゼロが設定される。
• DynStruct の場合、空の例外では現在位置が -1 に、それ以外の TypeCode では現在位置がゼロに設定される。メンバーがあれば、そのデフォルト値に (再帰的に) 初期化される。
• DynArray の場合、現在位置がゼロに設定され、要素がデフォルト値に (再帰的に) 初期化される。
• DynUnion の場合、現在位置がゼロに設定される。判別子の値は、共用体で最初に指定されたメンバーに一致する値に設定される。このメンバーはアクティブ化され、(再帰的に) デフォルト値に初期化される。
• DynValue および DynValueBox の場合、null 値に初期化される。

例外:

InconsistentTypeCode