org.omg.PortableInterceptor

Interface RequestInfoOperations

All Known Subinterfaces:

ClientRequestInfo， ClientRequestInfoOperations， RequestInfo， ServerRequestInfo， ServerRequestInfoOperations

public interface RequestInfoOperations

请求信息，访问拦截。

每个截取点被给定一个对象，通过该对象，该拦截器可以访问请求信息。客户端和服务器端拦截点关心的信息是不同的，所以有两个信息对象：ClientRequestInfo传递到客户端拦截点和ServerRequestInfo传递到服务器端拦截点。但这是共同的信息，所以他们都继承自一个共同的接口：RequestInfo。

另请参见：

ClientRequestInfo， ServerRequestInfo

方法摘要

Modifier and Type	Method and Description
Parameter[]	arguments() 返回 Parameter对象的数组，包含被调用的操作参数。
String[]	contexts() 返回 String对象描述，可以通过此操作调用的上下文中的数组。
TypeCode[]	exceptions() 返回 TypeCode对象描述用户异常操作调用可以扔 TypeCodes数组。
Object	forward_reference() 包含该请求将被转发的对象，如果 reply_status属性 LOCATION_FORWARD。
ServiceContext	get_reply_service_context(int id) 返回与答复相关联的给定的服务上下文的副本。
ServiceContext	get_request_service_context(int id) 返回与请求关联的服务上下文的副本。
Any	get_slot(int id) 返回给定的 PortableInterceptor.Current是在要求的范围内的数据。
String[]	operation_context() 返回 String对象包含了语境的被请求的数组。
String	operation() 返回调用的操作的名称。
short	reply_status() 描述操作调用的结果的状态。
int	request_id() 返回唯一标识一个活动请求/应答序列的标识号。
boolean	response_expected() 指示是否响应响应。
Any	result() 返回一个包含操作调用的结果的函数。
short	sync_scope() 定义在控件返回到客户端之前的请求的进度如何。

方法详细信息

request_id

int request_id()

返回唯一标识一个活动请求/应答序列的标识号。一旦一个请求/答复序列结束，这个身份证可以重复使用。注意，这个ID是不是GIOP request_id相同。如果GIOP所使用的传输机制，那么这些ID很可能是相同的，但这不保证也不需要。

operation

String operation()

返回调用的操作的名称。

arguments

Parameter[] arguments()

返回 Parameter对象的数组，包含被调用的操作参数。如果没有参数，此属性将是一零个长度数组。

并非所有的环境都提供对参数的访问。用java便携式绑定，例如，参数是不可用的。在这些环境中，当这个属性被访问，NO_RESOURCES将抛出一个标准的小代码1。

注：参数可用于DSI / DII调用。

异常

NO_RESOURCES如果参数不可抛。

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

exceptions

TypeCode[] exceptions()

返回 TypeCode对象描述用户异常操作调用可以扔 TypeCodes数组。如果没有用户异常，则将返回一零个长度数组。

并不是所有的环境都提供对异常列表的访问。用java便携式绑定，例如，例外列表不可用。在这些环境中，当这个属性被访问，NO_RESOURCES将抛出一个标准的小代码1。

注意：例外可DSI / DII调用。

异常

NO_RESOURCES如果例外不可抛。

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

contexts

String[] contexts()

返回 String对象描述，可以通过此操作调用的上下文中的数组。如果没有上下文，这将返回一零个长度数组。

并不是所有的环境都提供访问上下文列表的访问。用java便携式绑定，例如，上下文列表不可用。在这些环境中，当这个属性被访问，NO_RESOURCES将抛出一个标准的小代码1。

注：上下文可用DSI / DII调用。

异常

NO_RESOURCES如果上下文不可用扔。

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

operation_context

String[] operation_context()

返回 String对象包含了语境的被请求的数组。

并非所有的环境都提供对上下文的访问。用java便携式绑定，例如，上下文不可用。在这些环境中，当这个属性被访问，no_resources将抛出1标准小代码。

注：operation_context供DSI / DII调用。

异常

NO_RESOURCES -扔如果操作上下文不可用。

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

result

Any result()

返回一个包含操作调用的结果的函数。如果返回类型是void，此属性将是一个含有一个 TCKind价值和没有价值的 tk_void类型代码。

并非所有的环境都提供对结果的访问。用java便携式绑定，例如，结果是不可用的。在这些环境中，当这个属性被访问，NO_RESOURCES将抛出一个标准的小代码1。

注：可为DSI / DII调用。

异常

NO_RESOURCES如果结果不可抛。

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

response_expected

boolean response_expected()

指示是否响应响应。

在客户端，回复不回来时response_expected是虚假的，所以receive_reply不能称为。receive_other除非发生异常，在这种情况下，receive_exception叫做。

在send_poll客户端，这个属性是真实的。

sync_scope

short sync_scope()

定义在控件返回到客户端之前的请求的进度如何。这是在消息规范的定义，以及相关的只有 response_expected是假的。如果 response_expected是真实的价值是不确定的， sync_scope。此属性可能有下列值之一：在服务器

• Messaging.SYNC_NONE
• Messaging.SYNC_WITH_TRANSPORT
• Messaging.SYNC_WITH_SERVER
• Messaging.SYNC_WITH_TARGET

，所有范围，答复将从目标操作调用的返回了，但答复不会返回给客户端。虽然它不返回到客户端，它确实发生了，所以正常的服务器端拦截点后（即 receive_request_service_contexts， receive_request， send_reply或 send_exception）。

对于SYNC_WITH_SERVER和SYNC_WITH_TARGET，服务器会发送一个空回复客户在目标被调用。这个回答是不是由服务器端的拦截器拦截。

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

reply_status

short reply_status()

描述操作调用的结果的状态。返回值可以是下列之一：在客户端

• PortableInterceptor.SUCCESSFUL
• PortableInterceptor.SYSTEM_EXCEPTION
• PortableInterceptor.USER_EXCEPTION
• PortableInterceptor.LOCATION_FORWARD
• PortableInterceptor.TRANSPORT_RETRY

：

• 在receive_reply拦截点，这将只返回SUCCESSFUL
。
• 在receive_exception拦截点，这将是SYSTEM_EXCEPTION或USER_EXCEPTION。
• 在receive_other拦截点，这将是任何：SUCCESSFUL，LOCATION_FORWARD，或TRANSPORT_RETRY。SUCCESSFUL意味着一个异步请求返回成功。LOCATION_FORWARD意味着答复回来LOCATION_FORWARD的地位。TRANSPORT_RETRY意味着运输的机制表明重试一NEEDS_ADDRESSING_MODE GIOP回复状态，例如。

服务器上：

• 在send_reply拦截点，这才是SUCCESSFUL。
• 在send_exception拦截点，这将是SYSTEM_EXCEPTION或USER_EXCEPTION。
• 在send_other拦截点，这个属性将有：SUCCESSFUL，或LOCATION_FORWARD。SUCCESSFUL意味着一个异步请求返回成功。LOCATION_FORWARD意味着答复回来LOCATION_FORWARD的地位。

另请参见：

SUCCESSFUL， SYSTEM_EXCEPTION， USER_EXCEPTION， LOCATION_FORWARD， TRANSPORT_RETRY

forward_reference

Object forward_reference()

包含该请求将被转发的对象，如果 reply_status属性 LOCATION_FORWARD。它是不确定是否转发请求居然会发生。

get_slot

Any get_slot(int id)
      throws InvalidSlot

返回给定的 PortableInterceptor.Current是在要求的范围内的数据。

如果给定的时隙没有被设置，那么任何一种含有一个TCKind tk_null类型代码返回值。

参数

id -槽是返回的 SlotId。

结果

插槽数据，以任何形式的，与给定的标识符获得的。

异常

InvalidSlot -如果身份不确定所分配的时隙扔。

另请参见：

Current

get_request_service_context

ServiceContext get_request_service_context(int id)

返回与请求关联的服务上下文的副本。

参数

id -这是要返回的服务上下文的 IOP.ServiceId。

结果

与给定的标识符取得 IOP.ServiceContext。

异常

BAD_PARAM -抛出标准的小代码26，如果请求的服务内容不包含ID.项

get_reply_service_context

ServiceContext get_reply_service_context(int id)

返回与答复相关联的给定的服务上下文的副本。

参数

id -这是要返回的服务上下文的 IOP.ServiceId。

结果

与给定的标识符取得 IOP.ServiceContext。

异常

BAD_PARAM -抛出标准的小代码26如果请求的服务内容不包含ID.项