JavaTM 2
Platform
Std. Ed. v1.4.0

org.omg.CORBA
クラス NVList

java.lang.Object
  |
  +--org.omg.CORBA.NVList

public abstract class NVList
extends Object

NamedValue オブジェクトが格納された変更可能リストです。

NVList クラスは、次の目的で使用されます。

NamedValue オブジェクトは、以下で構成されます。

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.valueARG_OUT.valueARG_INOUT.value のいずれかを指定できます。

パラメータ:
flags - 引数モードフラグのいずれか
戻り値:
新しく生成された NamedValue オブジェクト

add_item

public abstract NamedValue add_item(String item_name,
                                    int flags)
指定された名前とフラグで初期化された新しい NamedValue オブジェクトを作成し、それをこの NVList オブジェクトの末尾に追加します。フラグには、引数引き渡しモード ARG_IN.valueARG_OUT.valueARG_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.valueARG_OUT.valueARG_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 オブジェクト数以上の場合

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.