方法详细信息

• 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。