モジュール java.corba
パッケージ 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​(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オブジェクトを削除します。
    • コンストラクタの詳細

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