Request (Java Platform SE 8 )

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

```
public abstract class Request
extends Object
```
包含调用方法所必需的信息的对象。这个类是ORB的动态调用接口的基石（DII），它允许动态创建和调用请求。服务器无法使用客户端存根和请求使用DII客户端调用的区别。
一个Request对象由：
- 要调用的操作的名称
- 一个NVList含参数的operation.
  列表中的每个项目是一个NamedValue对象，其中有三个部分：
  1. 参数的名称
  2. 这个参数的值（如一个Any对象）
  3. 参数模式标志，该标志指示参数是否为输入、输出或两者都是
Request对象也可以包含更多的信息，这取决于如何操作是在原来的IDL接口定义。例如，在适当的地方，它们可能含有NamedValue对象将返回值或异常的背景下，一系列可能的例外，并列表上下文字符串需要解决。

新的Request对象使用一个在Object班create_request方法创建。换句话说，一个create_request方法，被调用的对象进行。
另请参见：

NamedValue

构造方法摘要

构造方法

Constructor and Description

Request()

构造方法
Constructor and Description
`Request()`

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`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()` 检索目标对象引用。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - 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对象。该列表包含上下文 Strings需要解决与调用发送。
    
    结果
    
    值需要解析并发送的上下文字符串列表。
  - ctx
```
public abstract Context ctx()
```
    检索该请求 Context对象。这是一个关于客户端，环境，或这个请求的情况的属性的列表。
    
    结果
    
    这是用来解决任何上下文字符串的值需要在调用发送 Context对象
  - ctx
```
public abstract void ctx(Context c)
```
    设置请求的 Context对象到一个给定的。
    
    参数
    
    c -新的 Context对象可用于解决上下文字符串
  - add_in_arg
```
public abstract Any add_in_arg()
```
    创建一个输入参数并将它添加到该 Request对象。
    
    结果
    
    一个 Any对象包含输入参数的值和TypeCode添加
  - add_named_in_arg
```
public abstract Any add_named_in_arg(String name)
```
    创建具有给定名称和输入参数添加到这个 Request对象。
    
    参数
    
    name -参数被添加的名称
    
    结果
    
    一个 Any对象包含输入参数的值和TypeCode添加
  - add_inout_arg
```
public abstract Any add_inout_arg()
```
    增加了一个输入/输出参数，这 Request对象。
    
    结果
    
    一个 Any对象包含输入/输出参数的值和TypeCode添加
  - add_named_inout_arg
```
public abstract Any add_named_inout_arg(String name)
```
    添加一个具有给定名称的输入/输出参数，这 Request对象。
    
    参数
    
    name -参数被添加的名称
    
    结果
    
    一个 Any对象包含输入/输出参数的值和TypeCode添加
  - add_out_arg
```
public abstract Any add_out_arg()
```
    增加了一个输出参数这 Request对象。
    
    结果
    
    一个 Any对象包含输出参数的值和TypeCode添加
  - add_named_out_arg
```
public abstract Any add_named_out_arg(String name)
```
    添加一个相同名称的输出参数这 Request对象。
    
    参数
    
    name -参数被添加的名称
    
    结果
    
    一个 Any对象包含输出参数的值和TypeCode添加
  - set_return_type
```
public abstract void set_return_type(TypeCode tc)
```
    设置方法的返回值的TypeCode。
    
    参数
    
    tc - TypeCode对象包含类型信息的返回值
  - return_value
```
public abstract Any return_value()
```
    返回包含该方法的结果的价值 Any对象。
    
    结果
    
    包含返回值的值和一个 Any TypeCode对象
  - invoke
```
public abstract void invoke()
```
    使同步调用的 Request对象使用信息。异常信息放入 Request对象的环境对象。
  - send_oneway
```
public abstract void send_oneway()
```
    对单向调用请求。换句话说，它不期望或等待一个响应。注意，这可即使操作未声明为在IDL申报单用。没有返回响应或异常信息。
  - send_deferred
```
public abstract void send_deferred()
```
    对请求进行异步调用。换句话说，它不等待响应在它返回给用户之前。用户可以再使用的方法 poll_response和 get_response得到结果或异常的调用信息。
  - poll_response
```
public abstract boolean poll_response()
```
    允许用户确定响应是否已收到的调用触发前的 send_deferred方法。
    
    结果
    
    true如果方法响应已经收到； false否则
  - get_response
```
public abstract void get_response()
                           throws WrongTransaction
```
    允许用户访问调用的响应与 send_deferred提前触发方法。
    
    异常
    
    WrongTransaction如果方法调用 get_response从不同的交易的范围比一个从最初发送的请求。看到OMG交易服务规范细节。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Request

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

Request

方法详细信息

target

operation

arguments

result

env

exceptions

contexts

ctx

ctx

add_in_arg

add_named_in_arg

add_inout_arg

add_named_inout_arg

add_out_arg

add_named_out_arg

set_return_type

return_value

invoke

send_oneway

send_deferred

poll_response

get_response