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 物件
• 一個參數網要標誌

可以使用以下 ORB 方法之一創建 NVList 物件：

1. org.omg.CORBA.ORB.create_list

       org.omg.CORBA.NVList nv = orb.create_list(3);
    

   變數 nv 表示一個新創建的 NVList 物件。該參數是 orb 的記憶體管理提示，並不意味著實際的列表長度。例如，如果要在某一請求中使用 NVList 物件，則將被調用的方法將採用三個參數，您可以通過向 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 表示新創建的 NVList 物件，該物件包含對給定 OperationDef 物件中所描述方法的參數的描述。

NVList 類別中的方法都要處理列表中的 NamedValue 物件。有三個方法可用於添加 NamedValue 物件，一個方法用於獲得列表中 NamedValue 物件的計數，另一個方法用於檢索給定索引處的 NamedValue 物件，還有一個方法用於移除給定索引處的 NamedValue 物件。

從以下版本開始：

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 物件的索引都將向下移動一位。

參數：

index - 要移除的 NamedValue 物件的索引，該索引必須在 0 與列表長度減 1（包括兩者）之間。第一個項位於索引 0 處。

拋出：

Bounds - 如果索引大於或等於列表中 NamedValue 物件的個數