Java org.omg.CORBA 类 Request（JDK5）

183 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

org.omg.CORBA
类 Request

java.lang.Object
  org.omg.CORBA.Request

public abstract class Request
extends Object
extends Object

包含调用某一方法所必需的信息的对象。此类是 ORB 动态调用接口（Dynamic Invocation Interface，DII）的基石，它允许动态创建并调用请求。服务器无法判断使用客户端 stub 的客户端调用与使用 DII 的请求之间的不同。

Request 对象由以下内容组成：

将被调用的操作的名称
包含用于该操作的参数的 NVList。
该列表中的每一项都是一个 NamedValue 对象，它由三部分组成：
1. 参数的名称
2. 参数值（以 Any 对象的形式存在）
3. 指示该参数是用于输入、输出，还是同时用于这二者的参数模式标志

Request 对象还可以包含附加信息，这取决于原始 IDL 接口定义中对操作的定义。例如，在合适的地方可以包含一个 NamedValue 对象来保存返回值、异常、上下文、可能异常的列表和需要解析的上下文字符串列表。

新的 Request 对象是使用 Object 类中的 create_request 方法之一创建的。换句话说，create_request 方法是在将被调用的对象上执行的。

另请参见：: NamedValue

构造方法摘要
`Request()`

方法摘要
`abstract Any`	`add_in_arg()` 创建一个输入参数，并将它添加到此 `Request` 对象中。
`abstract Any`	`add_inout_arg()` 将一个输入/输出参数添加到此 `Request` 对象中。
`abstract Any`	`add_named_in_arg(String name)` 使用给定名称创建一个输入参数，并将它添加到此 `Request` 对象中。
`abstract Any`	`add_named_inout_arg(String name)` 将具有给定名称的输入/输出参数添加到此 `Request` 对象中。
`abstract Any`	`add_named_out_arg(String name)` 将具有给定名称的输出参数添加到此 `Request` 对象中。
`abstract Any`	`add_out_arg()` 将输出参数添加到此 `Request` 对象中。
`abstract NVList`	`arguments()` 检索包含将被调用方法的参数的 `NVList` 对象。
`abstract ContextList`	`contexts()` 检索用于此请求的 `ContextList` 对象。
`abstract Context`	`ctx()` 检索用于此请求的 `Context` 对象。
`abstract void`	`ctx(Context c)` 将此请求的 `Context` 对象设置为给定对象。
`abstract Environment`	`env()` 检索用于此请求的 `Environment` 对象。
`abstract ExceptionList`	`exceptions()` 检索用于此请求的 `ExceptionList` 对象。
`abstract void`	`get_response()` 允许用户访问之前使用 `send_deferred` 方法所触发调用的响应。
`abstract void`	`invoke()` 使用 `Request` 对象中的信息进行同步调用。
`abstract String`	`operation()` 检索将被调用的方法的名称。
`abstract boolean`	`poll_response()` 允许用户确定是否已接收到之前使用 `send_deferred` 方法所触发调用的响应。
`abstract NamedValue`	`result()` 检索包含该方法的返回值的 `NamedValue` 对象。
`abstract Any`	`return_value()` 返回包含方法结果值的 `Any` 对象。
`abstract void`	`send_deferred()` 对请求进行异步调用。
`abstract void`	`send_oneway()` 在请求上执行单向调用。
`abstract void`	`set_return_type(TypeCode tc)` 设置该方法返回值的 typecode。
`abstract Object`	`target()` 检索目标对象引用。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

Request

public Request()

方法详细信息

target

public abstract Object target()

检索目标对象引用。

返回：: 对象引用，指向将被调用的方法的对象实现

operation

public abstract String operation()

检索将被调用的方法的名称。

返回：: 将被调用的方法的名称

arguments

public abstract NVList arguments()

检索包含将被调用方法的参数的 NVList 对象。列表中的元素都是 NamedValue 对象，每个元素描述该方法的一个参数。

返回：: 包含该方法的参数的 NVList 对象

result

public abstract NamedValue result()

检索包含该方法的返回值的 NamedValue 对象。

返回：: 包含该方法的结果的 NamedValue 对象

env

public abstract Environment env()

检索用于此请求的 Environment 对象。它包含被调用的方法所抛出的异常（在调用返回之后）。

返回：: 用于此请求的 Environment 对象

exceptions

public abstract ExceptionList exceptions()

检索用于此请求的 ExceptionList 对象。此列表包含 TypeCode 对象，这些对象描述将被调用的方法可能抛出的异常。

返回：: ExceptionList 对象，该对象描述将被调用的方法可能抛出的异常

contexts

public abstract ContextList contexts()

检索用于此请求的 ContextList 对象。此列表包含需要解析并随调用发送的上下文 String。

返回：: 其值需要解析并随调用发送的上下文字符串所组成的列表。