DynAnyOperations (Java Platform SE 7)

既知のすべてのサブインタフェース:

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 オブジェクトを通して動的に解釈 (トラバース) および構築できます。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 オブジェクトを新規作成するための操作をエクスポートします。作成されるオブジェクトはそれぞれ構築型のデータ値のコンポーネントに関連付けられます。たとえば、DynStruct は struct 値と関連付けられます。つまり、DynStruct は、構造体のメンバーごとにコンポーネントが 1 つずつあるような、順序付けられたコレクションを所有するとみなすことができます。DynStruct オブジェクトは、struct のメンバーに関連付けられる DynAny オブジェクトを新規作成するための操作をエクスポートします。
別の (構築型) DynAny から DynAny オブジェクトを得た場合、たとえば DynStruct から作成された、構造体メンバーを表す DynAny は、DynStruct に論理的に含まれることになります。insert または get 操作を呼び出しても、現在位置は変更されません。最上位の DynAny オブジェクト (別の DynAny のコンポーネントではないもの) を破棄すると、そのコンポーネントの DynAny も破棄されます。最上位ではない DynAny を破棄した場合は何も起こりません。破棄された最上位の DynAny、またはその下位オブジェクトに対して操作を呼び出すと、OBJECT_NOT_EXIST がスローされます。DynAny を破棄したあとも、それに関連付けられるデータ値のコンポーネントを操作するには、まずコンポーネントの DynAny を作成してから、作成した DynAny オブジェクトのコピーを作成します。
DynAny オブジェクトの動作は、割り当てられたメモリー空間とアクセス速度に関して効果的な実装を実現できるように定義されています。DynAny オブジェクトは、実行時に any から抽出された値のトラバースや、any の値の構築を行うために使用することが想定されています。ほかの用途での使用はお勧めできません。
insert と get の各操作は、基本 DynAny オブジェクトの操作に必要ですが、構築型 DynAny オブジェクトの操作にも役立ちます。構築型 DynAny オブジェクトに基本データ型の値を挿入すると、DynAny オブジェクトに関連付けられた構築型データ値の現在のコンポーネントを初期化することになります。たとえば、DynStruct で insert_boolean を呼び出すと、関連する struct のデータ値の現在位置に boolean のデータ値が挿入されます。値の TypeCode が DynAny に含まれる TypeCode と同じである場合、値の挿入と抽出を通して型は同じになります。DynAny にコンポーネントがある場合は、値の挿入と抽出における型は現在位置の DynAny の TypeCode と同じになります。
DynAny オブジェクトと DynAnyFactory オブジェクトは、それらが作成および使用されるプロセスに対してローカルであると想定されています。つまり、DynAny および DynAnyFactory オブジェクトへの参照をほかのプロセスにエクスポートしたり、ORB.object_to_string() で外部化したりすることはできません。実行を試みると MARSHAL システム例外が発生します。IDL にインタフェースが指定されているため、DynAny オブジェクトでは標準の org.omg.CORBA.Object インタフェースに定義されている操作をエクスポートできます。ただし、Object インタフェースを通してエクスポートした操作を呼び出そうとすると、標準 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 の現在位置は、値がコンポーネントを持つ場合はゼロに、コンポーネントを持たない場合は -1 に設定されます。
    
    パラメータ:
    dyn_any -
    
    例外:
    
    TypeMismatch - 渡された DynAny の型が、初期化される DynAny の型に一致しない場合
  - from_any
```
void from_any(Any value)
              throws TypeMismatch,
                     InvalidValue
```
    DynAny オブジェクトに関連付けられた値を、any に含まれる値で初期化します。初期化される DynAny の現在位置は、値がコンポーネントを持つ場合はゼロに、コンポーネントを持たない場合は -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 がコンポーネントを持たない場合はゼロを返します。コンポーネント数のカウントは、最上位だけに対して行われます。たとえば、メンバーが 1 つしかない DynStruct で component_count を呼び出すと、それがどのようなメンバーであっても戻り値は 1 になります。
    - シーケンスの場合、このオペレーションは現在の要素数を返します。
    - 構造体、例外、および値型の場合、このオペレーションはメンバーの数を返します。
    - 配列の場合、このオペレーションは要素数を返します。
    - 共用体の場合、指定されたメンバーがアクティブであると判別子が示す場合は 2、そうでない場合は 1 を返します。
    - DynFixed および DynEnum の場合、このオペレーションはゼロを返します。
  - 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 で呼び出された場合

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース DynAnyOperations

メソッドのサマリー

メソッドの詳細

type

assign

from_any

to_any

equal

destroy

copy

insert_boolean

insert_octet

insert_char

insert_short

insert_ushort

insert_long

insert_ulong

insert_float

insert_double

insert_string

insert_reference

insert_typecode

insert_longlong

insert_ulonglong

insert_wchar

insert_wstring

insert_any

insert_dyn_any

insert_val

get_boolean

get_octet

get_char

get_short

get_ushort

get_long

get_ulong

get_float

get_double

get_string

get_reference

get_typecode

get_longlong

get_ulonglong

get_wchar

get_wstring

get_any

get_dyn_any

get_val

seek

rewind

next

component_count

current_component