所有类


org.omg.PortableInterceptor
接口 RequestInfoOperations

所有已知子接口:
ClientRequestInfo, ClientRequestInfoOperations, RequestInfo, ServerRequestInfo, ServerRequestInfoOperations

public interface RequestInfoOperations

Interceptor 可访问的请求信息。

每个截取点都给定了一个对象,Interceptor 可以通过该对象访问请求信息。客户端和服务器端的截取点关注不同的信息,因此有两种信息对象:ClientRequestInfo 传递给客户端的截取点,ServerRequestInfo 传递给服务器端的截取点。但也有两者都需要的信息,所以这两个接口继承自同一个接口:RequestInfo

另请参见:
ClientRequestInfo, ServerRequestInfo

方法摘要
 Parameter[]arguments()
          返回一个 Parameter 对象数组,包含将调用的操作上的参数。
 String[]contexts()
          返回一个 String 对象数组,这些对象描述可以在此操作调用上传递的上下文。
 TypeCode[]exceptions()
          返回一个 TypeCode 对象数组,这些对象描述此操作调用可能抛出的用户异常的 TypeCode
 Objectforward_reference()
          如果 reply_status 属性为 LOCATION_FORWARD,则包含要将请求转发到的对象。
 ServiceContextget_reply_service_context(int id)
          返回具有给定 ID 的与应答关联的服务上下文复本。
 ServiceContextget_request_service_context(int id)
          返回具有给定 ID 的与请求关联的服务上下文复本。
 Anyget_slot(int id)
          返回请求域内 PortableInterceptor.Current 给定槽 (slot) 中的数据。
 String[]operation_context()
          返回一个 String 对象数组,这些对象包含将在请求上发送上下文。
 Stringoperation()
          返回将被调用的操作的名称。
 shortreply_status()
          描述操作调用结果的状态。
 intrequest_id()
          返回唯一地标识激活的请求/应答序列的 id。
 booleanresponse_expected()
          指示是否希望响应。
 Anyresult()
          返回一个 any,它包含该操作调用的结果。
 shortsync_scope()
          定义在控制信息返回到客户端前请求应前进的距离。
 

方法详细信息

request_id

int request_id()
返回唯一地标识激活的请求/应答序列的 id。请求/应答序列一结束此 ID 即可重用。注意,此 id 不同于 GIOP request_id。如果使用的传送机制是 GIOP,则这些 ID 很可能是相同的,但是不保证也不要求如此。


operation

String operation()
返回将被调用的操作的名称。


arguments

Parameter[] arguments()
返回一个 Parameter 对象数组,包含将调用的操作上的参数。如果没有参数,则此属性将是一个 0 长度数组。

并非所有环境都提供对参数的访问。例如,使用 Java 可移植绑定时参数将不可用。在这些环境中访问此属性时,将抛出 NO_RESOURCES,并带有标准次要代码 1。

注:对于 DSI/DII 调用参数是可用的。

抛出:
NO_RESOURCES - 如果参数不可用。
另请参见:
PortableInterceptor 包中关于限制/未实现特性的注释

exceptions

TypeCode[] exceptions()
返回一个 TypeCode 对象数组,这些对象描述此操作调用可能抛出的用户异常的 TypeCode。如果没有用户异常,则此方法返回一个长度为 0 的数组。

并非所有环境都提供对异常列表的访问。例如,使用 Java 可移植绑定时异常列表将不可用。在这些环境中访问此属性时,将抛出 NO_RESOURCES,并带有标准次要代码 1。

注:异常对于 DSI/DII 调用是可用的。

抛出:
NO_RESOURCES - 如果异常不可用。
另请参见:
PortableInterceptor 包中关于限制/未实现特性的注释

contexts

String[] contexts()
返回一个 String 对象数组,这些对象描述可以在此操作调用上传递的上下文。如果没有上下文,则此方法返回一个长度为 0 的数组。

并非所有环境都提供对上下文列表的访问。例如,使用 Java 可移植绑定时上下文列表将不可用。在这些环境中访问此属性时,将抛出 NO_RESOURCES,并带有标准次要代码 1。

注:上下文对于 DSI/DII 调用是可用的。

抛出:
NO_RESOURCES - 如果上下文不可用。
另请参见:
PortableInterceptor 包中关于限制/未实现特性的注释

operation_context

String[] operation_context()
返回一个 String 对象数组,这些对象包含将在请求上发送上下文。

并非所有环境都提供对上下文的访问。例如,使用 Java 可移植绑定时上下文将不可用。在这些环境中访问此属性时,将抛出 NO_RESOURCES,并带有标准次代码 1。

注:operation_context 对于 DSI/DII 调用是可用的。

抛出:
NO_RESOURCES - 如果操作上下文不可用。
另请参见:
PortableInterceptor 包中关于限制/未实现特性的注释

result

Any result()
返回一个 any,它包含该操作调用的结果。如果操作返回类型为空,则此属性将是包含 TCKind 值为 tk_void 的类型代码的 any,并且该 any 不包含任何值。

并非所有环境都提供对结果的访问。例如,使用 Java 可移植绑定时结果将不可用。在这些环境中访问此属性时,将抛出 NO_RESOURCES,并带有标准次要代码 1。

注:结果对于 DSI/DII 调用是可用的。

抛出:
NO_RESOURCES - 如果结果不可用。
另请参见:
PortableInterceptor 包中关于限制/未实现特性的注释