org.omg.CORBA

クラス NVList

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 メソッドのいずれかを使用して作成できます。

1. 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 オブジェクトを追加することも可能。

2. 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

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
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 NamedValue	add(int flags) 指定されたフラグで初期化された NamedValue オブジェクトを新規作成し、それをこの NVList オブジェクトの末尾に追加します。
abstract int	count() この NVList オブジェクトに追加された NamedValue オブジェクトの数を返します。
abstract NamedValue	item(int index) 指定されたインデックスでの NamedValue を取得します。
abstract void	remove(int index) 指定されたインデックスにある NamedValue オブジェクトを削除します。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

NVList

public NVList()

メソッドの詳細

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 オブジェクトの数と等しいか、それよりも大きい場合