JavaTM Platform
Standard Ed. 6

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.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 オブジェクトの数以上の 場合

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。