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对象描述 TypeCode s表示此操作调用可能抛出用户异常。
Object	forward_reference() 如果 reply_status属性为 LOCATION_FORWARD ，则包含请求转发的对象。
ServiceContext	get_reply_service_context(int id) 使用与回复关联的给定ID返回服务上下文的副本。
ServiceContext	get_request_service_context(int id) 使用与请求相关联的给定ID返回服务上下文的副本。
Any	get_slot(int id) 返回来自请求范围的 PortableInterceptor.Current的给定槽中的数据。
String[]	operation_context() 返回一个 String对象的数组， String在请求中发送的上下文。
String	operation() 返回被调用的操作的名称。
short	reply_status() 描述操作调用结果的状态。
int	request_id() 返回唯一标识活动请求/回复序列的ID。
boolean	response_expected() 指示是否预期响应。
Any	result() 返回一个包含操作调用结果的值。
short	sync_scope() 定义在将控制权返回给客户端之前请求的进展程度。

方法详细信息

request_id

int request_id()

返回唯一标识活动请求/回复序列的ID。 一旦请求/回复顺序结束，该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对象描述TypeCode s表示此操作调用可能抛出用户异常。 如果没有用户异常，则返回零长度数组。

并非所有环境都提供对例外列表的访问。 例如，使用Java便携式绑定，例外列表不可用。 在这些环境中，当访问此属性时， NO_RESOURCES将被抛出，标准的次要代码为1。

注意：例外可用于DSI / DII电话。

异常

NO_RESOURCES - 如果异常 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便携式绑定，上下文不可用。 在这些环境中，当访问此属性时，将使用标准的次要代码1抛出NO_RESOURCES。

注： 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为false时，不会返回回复，所以receive_reply无法调用。 receive_other被调用，除非发生异常，在这种情况下receive_exception 。

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

sync_scope

short sync_scope()

定义在将控制权返回给客户端之前请求的进展程度。 这是在消息传递规范中定义的，只有response_expected为false时才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 - 如果ID未定义分配的插槽，则抛出。

另请参见：

Current

get_request_service_context

ServiceContext get_request_service_context(int id)

使用与请求相关联的给定ID返回服务上下文的副本。

参数

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

结果

用给定的 IOP.ServiceContext获得的IOP.ServiceContext。

异常

BAD_PARAM - 如果请求的服务上下文不包含该ID的条目，则抛出标准的次要代码26。

get_reply_service_context

ServiceContext get_reply_service_context(int id)

使用与回复关联的给定ID返回服务上下文的副本。

参数

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

结果

用给定的 IOP.ServiceContext获得的IOP.ServiceContext。

异常

BAD_PARAM - 如果请求的服务上下文不包含该ID的条目，则抛出标准的次要代码26。