- java.lang.Object
-
- org.omg.CORBA.NVList
-
public abstract class NVList extends Object
NamedValue
オブジェクトが格納された変更可能リストです。NVList
クラスは、次の目的で使用されます。- Dynamic Invocation InterfaceとDynamic Skeleton Interfaceで
Request
オブジェクトの引数を記述するため Context
オブジェクトのコンテキスト値を記述するため
各
NamedValue
オブジェクトは、次の内容で構成されます。- 名前(
String
オブジェクト) - 値(
Any
オブジェクト) - 引数モード・フラグ
NVList
オブジェクトは、次のORB
メソッドのいずれかを使用して作成できます。org.omg.CORBA.ORB.create_list
org.omg.CORBA.NVList nv = orb.create_list(3);
変数nv
は新たに作成されたNVList
オブジェクトを表す。 引数はORBに対するメモリー管理ヒントであり、リストの実際の長さを示すものではない。 たとえば、リクエストにNVList
オブジェクトを使用し、呼び出されるメソッドが3つのパラメータを取る場合、create_list
メソッドに3を指定して最適化できる。 新しいNVList
は必ずしも長さ3ではなく、たとえば、長さが2または4の場合がある。 元の長さに関係なく、このリストに任意の数のNamedValue
オブジェクトを追加することも可能。org.omg.CORBA.ORB.create_operation_list
org.omg.CORBA.NVList nv = orb.create_operation_list(myOperationDef);
変数nv
は、指定されたOperationDef
オブジェクトで記述されるメソッドの引数記述を格納している、新しく生成されたNVList
オブジェクトを表す。
NVList
クラスのメソッドはすべて、リスト内のNamedValue
オブジェクトを処理します。NamedValue
オブジェクトの追加用メソッドには、リスト内のNamedValue
オブジェクトの数を取得するメソッド、指定したインデックスのNamedValue
オブジェクトを取得するメソッド、および指定したインデックスのNamedValue
オブジェクトを削除するメソッド、の3つがあります。- 導入されたバージョン:
- JDK1.2
- 関連項目:
Request
,ServerRequest
,NamedValue
,Context
- Dynamic Invocation InterfaceとDynamic Skeleton Interfaceで
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 NVList()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 abstract NamedValue
add(int flags)
指定されたフラグで初期化されたNamedValue
オブジェクトを新規作成し、それをこのNVList
オブジェクトの末尾に追加します。abstract NamedValue
add_item(String item_name, int flags)
指定された名前とフラグで初期化された新しいNamedValue
オブジェクトを作成し、それをこのNVList
オブジェクトの末尾に追加します。abstract NamedValue
add_value(String item_name, Any val, int flags)
指定された名前、値、およびフラグで初期化された新しいNamedValue
オブジェクトを作成し、それをこのNVList
オブジェクトの末尾に追加します。abstract int
count()
このNVList
オブジェクトに追加されたNamedValue
オブジェクトの数を返します。abstract NamedValue
item(int index)
指定されたインデックスでのNamedValue
を取得します。abstract void
remove(int index)
指定されたインデックスにあるNamedValue
オブジェクトを削除します。
-
-
-
メソッドの詳細
-
count
public abstract int count()
このNVList
オブジェクトに追加されたNamedValue
オブジェクトの数を返します。- 戻り値:
- この
NVList
内のNamedValue
オブジェクトの数を示すint
。
-
add
public abstract NamedValue add(int flags)
指定されたフラグで初期化されたNamedValue
オブジェクトを新規作成し、それをこのNVList
オブジェクトの末尾に追加します。 フラグには、引数引渡しモードARG_IN.value
、ARG_OUT.value
、ARG_INOUT.value
のいずれかを指定できます。- パラメータ:
flags
- 引数モード・フラグのいずれか- 戻り値:
- 新しく作成された
NamedValue
オブジェクト
-
add_item
public abstract NamedValue add_item(String item_name, int flags)
指定された名前とフラグで初期化された新しいNamedValue
オブジェクトを作成し、それをこのNVList
オブジェクトの末尾に追加します。 フラグには、引数引渡しモードARG_IN.value
、ARG_OUT.value
、ARG_INOUT.value
のいずれかを指定できます。- パラメータ:
item_name
- 新しいNamedValue
オブジェクトの名前flags
- 引数モード・フラグのいずれか- 戻り値:
- 新しく作成された
NamedValue
オブジェクト
-
add_value
public abstract NamedValue add_value(String item_name, Any val, int flags)
指定された名前、値、およびフラグで初期化された新しいNamedValue
オブジェクトを作成し、それをこのNVList
オブジェクトの末尾に追加します。- パラメータ:
item_name
- 新しいNamedValue
オブジェクトの名前val
- 新しいNamedValue
オブジェクトの値を含むAny
オブジェクトflags
- 引数引渡しモードARG_IN.value
、ARG_OUT.value
、またはARG_INOUT.value
のいずれか- 戻り値:
- 新しく作成された
NamedValue
オブジェクト
-
item
public abstract NamedValue item(int index) throws Bounds
指定されたインデックスでのNamedValue
を取得します。- パラメータ:
index
- 対象のNamedValue
オブジェクトのインデックス。インデックスは、0から(リストの長さ - 1)までの値にする必要がある。 最初の項目のインデックスは0になる。- 戻り値:
- 指定されたインデックスでの
NamedValue
- 例外:
Bounds
- インデックスがNamedValue
オブジェクトの数と等しいか、それよりも大きい場合
-
remove
public abstract void remove(int index) throws Bounds
指定されたインデックスにあるNamedValue
オブジェクトを削除します。 削除されたNamedValue
オブジェクト以降のすべてのインデックスが1だけ減少します。- パラメータ:
index
- 削除されるNamedValue
オブジェクトのインデックス。インデックスは、0から(リストの長さ - 1)までの値にする必要がある。 最初の項目のインデックスは0になる。- 例外:
Bounds
- インデックスがリスト内のNamedValue
オブジェクトの数と等しいか、それよりも大きい場合
-
-