Module  java.corba
软件包  org.omg.PortableInterceptor

Interface RequestInfoOperations

    • 方法摘要

      所有方法  接口方法  抽象方法 
      Modifier and Type 方法 描述
      Parameter[] arguments​()
      返回一个 Parameter对象的数组，其中包含要调用的操作的参数。
      String[] contexts​()
      返回描述可以在此操作调用中传递的上下文的 String对象的数组。
      TypeCode[] exceptions​()
      返回一个 TypeCode对象的数组，描述这个操作调用可能抛出的用户异常的 TypeCode 。
      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​()
      返回被调用的操作的名称。
      String[] operation_context​()
      返回一个 String对象的数组，包含在请求中发送的上下文。
      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便携式绑定，参数不可用。 在这些环境中，当访问此属性时，将使用标准的次要代码1抛出NO_RESOURCES 。

        注意：参数可用于DSI / DII呼叫。

        异常
        NO_RESOURCES - 如果参数不可用，则抛出。
        另请参见：
        PortableInterceptor package comments for limitations / unimplemented features

      • exceptions

        TypeCode[] exceptions​()
        返回一个TypeCode对象的数组，描述这个操作调用可能抛出的用户异常的TypeCode 。 如果没有用户异常，则返回零长度数组。

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

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

        异常
        NO_RESOURCES - 如果异常不可用，则抛出。
        另请参见：
        PortableInterceptor package comments for limitations / unimplemented features

      • contexts

        String[] contexts​()
        返回描述可以在此操作调用中传递的上下文的String对象的数组。 如果没有上下文，这将返回零长度数组。

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

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

        注意：结果可用于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内，此属性为true。

      • sync_scope

        short sync_scope​()
        定义在将控制权返回给客户端之前请求的进展程度。 这是在消息传递规范中定义的，仅在response_expected为假时才response_expected 。 如果response_expected为true，则值为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具有给定的标识符。
        异常
        BAD_PARAM - 如果请求的服务上下文不包含该ID的条目，则抛出标准的次要代码26。

      • get_reply_service_context

        ServiceContext get_reply_service_context​(int id)
        使用与回复关联的给定ID返回服务上下文的副本。
        参数
        id - 要返回的服务上下文的 IOP.ServiceId 。
        结果
        获得的 IOP.ServiceContext具有给定的标识符。
        异常
        BAD_PARAM - 如果请求的服务上下文不包含该ID的条目，则抛出标准的次要代码26。