org.omg.PortableInterceptor

Interface ServerRequestInfoOperations

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。