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