ServerRequestInfoOperations (Java Platform SE 8 )

All Superinterfaces:

RequestInfoOperations

All Known Subinterfaces:

ServerRequestInfo
```
public interface ServerRequestInfoOperations
extends RequestInfoOperations
```
请求信息，可由服务器端请求拦截器访问。
对一些属性和操作ServerRequestInfo是不是在所有的拦截点有效。下表显示每个属性或操作的有效性。如果它无效，尝试访问它将导致BAD_INV_ORDER被抛出与14的标准次要代码。

receive_request_
service_contexts receive_request send_reply send_exception send_other Inherited from RequestInfo:
request_id
yes yes yes yes yes
operation
yes yes yes yes yes
arguments
no yes₁ yes no₂ no₂
exceptions
no yes yes yes yes
contexts
no yes yes yes yes
operation_context
no yes yes no no
result
no no yes no no
response_expected
yes yes yes yes yes
sync_scope
yes yes yes yes yes request_id yes yes yes yes yes operation yes yes yes yes yes arguments no yes₁ yes no₂ no₂ exceptions no yes yes yes yes contexts no yes yes yes yes operation_context no yes yes no no result no no yes no no response_expected yes yes yes yes yes sync_scope yes yes yes yes yes reply_status no no yes yes yes forward_reference no no no no yes₂ get_slot yes yes yes yes yes get_request_service_context yes no yes yes yes get_reply_service_context no no yes yes yes ServerRequestInfo-specific: sending_exception no no no yes no object_id no yes yes yes₃ yes₃ adapter_id no yes yes yes₃ yes₃ server_id no yes yes yes yes orb_id no yes yes yes yes adapter_name no yes yes yes yes target_most_derived_interface no yes no₄ no₄ no₄ get_server_policy yes yes yes yes yes set_slot yes yes yes yes yes target_is_a no yes no₄ no₄ no₄ add_reply_service_context yes yes yes yes yes
1. 当ServerRequestInfo传递给receive_request时，每个参数的列表中都有一个条目，无论是在inout还是out中。但是只有in和inout参数才可用。
2. 如果reply_status属性不是LOCATION_FORWARD ，访问此属性将抛出BAD_INV_ORDER与标准的次要代码14。
3. 如果servant定位器导致位置向前或引发异常，此属性/操作可能在此截取点中不可用。 NO_RESOURCES与标准的次要代码1将被抛出，如果它不可用。
4. 该拦截点不可用此操作，因为必要的信息需要访问目标对象的仆人，ORB可能不再可用。例如，如果对象的适配器是使用一个POA ServantLocator ，那么ORB将调用拦截点调用后ServantLocator.postinvoke()
另请参见：

ServerRequestInterceptor

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`byte[]`	`adapter_id()` 返回对象适配器的不透明标识符。
`String[]`	`adapter_name()` 返回标识正在处理此请求的对象适配器实例的字符串序列。
`void`	`add_reply_service_context(ServiceContext service_context, boolean replace)` 允许拦截器向请求添加服务上下文。
`Policy`	`get_server_policy(int type)` 返回给定策略类型的此操作的有效策略。
`byte[]`	`object_id()` 返回描述 `object_id`调用目标的不透明的object_id。
`String`	`orb_id()` 返回用于创建ORB的ID。
`Any`	`sending_exception()` 返回任何包含要返回给客户端的异常。
`String`	`server_id()` 返回使用-ORBServerId参数在ORB :: init上指定的服务器ID。
`void`	`set_slot(int id, Any data)` 允许Interceptor在设置的槽 `PortableInterceptor.Current`是在请求的范围。
`boolean`	`target_is_a(String id)` 如果servant是给定的存储库id，则返回true，否则返回false。
`String`	`target_most_derived_interface()` 返回servant最传导接口的存储库ID。

Methods inherited from interface org.omg.PortableInterceptor.RequestInfoOperations
arguments, contexts, exceptions, forward_reference, get_reply_service_context, get_request_service_context, get_slot, operation_context, operation, reply_status, request_id, response_expected, result, sync_scope

- 方法详细信息
  - sending_exception
```
Any sending_exception()
```
    返回任何包含要返回给客户端的异常。
    如果异常是不能插入任何用户异常（例如，未知或绑定不提供TypeCode ），那么该属性将包含系统异常UNKNOWN ，其中标准的次要代码为1 。
    
    另请参见：
    
    PortableInterceptor package comments for limitations / unimplemented features
  - object_id
```
byte[] object_id()
```
    返回描述 object_id调用目标的不透明的object_id。
  - adapter_id
```
byte[] adapter_id()
```
    返回对象适配器的不透明标识符。
  - server_id
```
String server_id()
```
    返回使用-ORBServerId参数在ORB :: init上指定的服务器ID。
  - orb_id
```
String orb_id()
```
    返回用于创建ORB的ID。
  - adapter_name
```
String[] adapter_name()
```
    返回标识正在处理此请求的对象适配器实例的字符串序列。
  - target_most_derived_interface
```
String target_most_derived_interface()
```
    返回servant最传导接口的存储库ID。
  - get_server_policy
```
Policy get_server_policy(int type)
```
    返回给定策略类型的此操作的有效策略。返回的CORBA.Policy对象只能是通过register_policy_factory类型的策略。
    
    参数
    
    type - CORBA.PolicyType要返回的策略的 CORBA.PolicyType 。
    
    结果
    
    以给定的策略类型获得 CORBA.Policy 。
    
    异常
    
    INV_POLICY - 抛出，标准的次要代码为2，如果给定类型的策略未通过 register_policy_factory 。
    
    另请参见：
    
    ORBInitInfoOperations.register_policy_factory(int, org.omg.PortableInterceptor.PolicyFactory)
  - set_slot
```
void set_slot(int id,
              Any data)
       throws InvalidSlot
```
    允许Interceptor在设置的槽PortableInterceptor.Current是在请求的范围。如果该插槽中已经存在数据，它将被覆盖。
    
    参数
    
    id - 插槽的ID。
    
    data - 以任何形式存储在该插槽中的数据。
    
    异常
    
    InvalidSlot - 如果ID未定义分配的插槽，则抛出。
    
    另请参见：
    
    Current
  - target_is_a
```
boolean target_is_a(String id)
```
    如果servant是给定的存储库id，则返回true，否则返回false。
    
    参数
    
    id - 调用者想知道仆人是否是这个存储库ID。
    
    结果
    
    仆人是给定的RepositoryId吗？
  - add_reply_service_context
```
void add_reply_service_context(ServiceContext service_context,
                               boolean replace)
```
    允许拦截器向请求添加服务上下文。
    没有声明服务上下文的顺序。他们可能会或不会按照添加的顺序出现。
    
    参数
    
    service_context - IOP.ServiceContext添加到回复。
    
    replace - 表示当具有给定ID的服务上下文已存在时此操作的行为。如果是false，那么BAD_INV_ORDER与标准的次要代码15被抛出。如果为true，则现有服务上下文将被新的服务上下文替换。
    
    异常
    
    BAD_INV_ORDER - 抛出，标准的次要代码为15，如果replace为false，并且服务上下文已经存在与给定的ID。

Interface ServerRequestInfoOperations

方法摘要

Methods inherited from interface org.omg.PortableInterceptor.RequestInfoOperations

方法详细信息

sending_exception

object_id

adapter_id

server_id

orb_id

adapter_name

target_most_derived_interface

get_server_policy

set_slot

target_is_a

add_reply_service_context