org.omg.CORBA

Class NVList

java.lang.Object

org.omg.CORBA.NVList

public abstract class NVList
extends Object

一个可修改的列表包含 NamedValue对象。

这类NVList应用如下：

• 描述在动态调用接口和动态框架接口一个Request对象参数
• 描述一Context对象上下文值

每个NamedValue对象包括以下：

• 一个名字，这是一个String对象
• 一个值，作为一个Any对象
• 参数模式标志

一个NVList对象可以使用下面的一个ORB方法创建：

1. org.omg.CORBA.ORB.create_list

   org.omg.corba.nvlist NV =球体。create_list（3）；

   变nv表示新创建的NVList对象。参数是一个内存管理提示ORB和并不意味着列表的实际长度。如果，例如，你想在一个请求使用一个NVList对象，和被调用的方法有三个参数，你可以通过提供3 create_list优化方法。值得注意的是，新的NVList未必会有一个长度为3；它可以有一个长度为2或4，例如。注意，你可以在这个列表中添加任意数量的NamedValue物体不论其原始长度。

2. org.omg.CORBA.ORB.create_operation_list

   org.omg.corba.nvlist NV =球体。create_operation_list（myoperationdef）；

   变nv表示新创建对象的方法NVList包含在给定的OperationDef对象描述的参数描述。

在课堂上NVList所有列表中的NamedValue对象处理方法。有一NamedValue添加对象的三种方法，一种获取表中的NamedValue对象的计数方法，一种方法检索NamedValue对象在一个给定的索引，和一个在一个给定的指标去除NamedValue对象的方法。

从以下版本开始：

支持

另请参见：

Request， ServerRequest， NamedValue， Context

构造方法摘要

构造方法

Constructor and Description
NVList()

方法摘要

Modifier and Type	Method and Description
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对象在给定的索引。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NVList

public NVList()

方法详细信息

count

public abstract int count()

返回已添加到该 NVList对象 NamedValue对象数。

结果

一个 int表示该 NVList的 NamedValue对象数。

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对象的索引，它必须是列表中减去一个零和的长度之间，包容。第一个项目是在索引零。

结果

给定索引处的 NamedValue对象

异常

Bounds -如果指数大于或等于 NamedValue对象数

remove

public abstract void remove(int index)
                     throws Bounds

删除 NamedValue对象在给定的索引。请注意，以下一个删除所有 NamedValue对象向下移动一个指标。

参数

index的 NamedValue对象被删除的指标，它必须是列表中减去一个零和的长度之间，包容。第一个项目是在索引零。

异常

Bounds -如果指数大于或等于列表中的 NamedValue对象数