当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

NVList (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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 对象的个数

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。