org.omg.PortableInterceptor

Interface ClientRequestInfoOperations

All Superinterfaces:

RequestInfoOperations

All Known Subinterfaces:

ClientRequestInfo

public interface ClientRequestInfoOperations
extends RequestInfoOperations

请求信息，客户端访问请求拦截器。

在ClientRequestInfo一些属性和操作不适用於所有拦截点。下表显示了每个属性或操作的有效性。如果它是无效的，试图访问它会导致一个BAD_INV_ORDER抛出一个标准的小代码14。

	send_request	send_poll	receive_reply	receive_exception	receive_other
Inherited from RequestInfo:
request_id	yes	yes	yes	yes	yes
operation	yes	yes	yes	yes	yes
arguments	yes1	no	yes	no	no
exceptions	yes	no	yes	yes	yes
contexts	yes	no	yes	yes	yes
operation_context	yes	no	yes	yes	yes
result	no	no	yes	no	no
response_expected	yes	yes	yes	yes	yes
sync_scope	yes	no	yes	yes	yes
reply_status	no	no	yes	yes	yes
forward_reference	no	no	no	no	yes2
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
ClientRequestInfo-specific:
target	yes	yes	yes	yes	yes
effective_target	yes	yes	yes	yes	yes
effective_profile	yes	yes	yes	yes	yes
received_exception	no	no	no	yes	no
received_exception_id	no	no	no	yes	no
get_effective_component	yes	no	yes	yes	yes
get_effective_components	yes	no	yes	yes	yes
get_request_policy	yes	no	yes	yes	yes
add_request_service_context	yes	no	no	no	no

1. 当ClientRequestInfo传递给send_request，有一个条目列表中的每个参数，是否，inout，或。但只有在和INOUT参数可。
2. 如果reply_status属性不LOCATION_FORWARD，访问该属性将BAD_INV_ORDER与标准的小代码14。

另请参见：

ClientRequestInterceptor

方法摘要

Modifier and Type	Method and Description
void	add_request_service_context(ServiceContext service_context, boolean replace) 允许拦截器添加服务上下文的要求。
TaggedProfile	effective_profile() 返回将用于发送请求的配置文件。
Object	effective_target() 返回调用操作将被调用的实际对象。
TaggedComponent	get_effective_component(int id) 返回与给定的ID从选定的这个请求的轮廓 IOP.TaggedComponent。
TaggedComponent[]	get_effective_components(int id) 从所选择的配置文件中返回给定的标识的所有标记组件的数组。
Policy	get_request_policy(int type) 返回此操作的效果的给定策略。
String	received_exception_id() 返回要返回给客户端的异常的存储库标识。
Any	received_exception() 返回一个包含要返回给客户端的异常的任何一个。
Object	target() 返回客户端调用的对象执行操作的对象。

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

方法详细信息

target

Object target()

返回客户端调用的对象执行操作的对象。

另请参见：

effective_target()

effective_target

Object effective_target()

返回调用操作将被调用的实际对象。如果 reply_status是 LOCATION_FORWARD，然后在后续的请求， effective_target将包含转发IOR目标将保持不变。

另请参见：

target()

effective_profile

TaggedProfile effective_profile()

返回将用于发送请求的配置文件。如果此操作的对象和对象的配置文件发生了更改，那么此配置文件将是位于该配置文件中的位置。

received_exception

Any received_exception()

返回一个包含要返回给客户端的异常的任何一个。

如果异常是一个用户异常不能插入任何（例如，它是未知的或绑定不提供TypeCode），那么这个属性将一个含有与一个标准的小代码1系统异常UNKNOWN。然而，该异常的库ID在received_exception_id属性是可用的。

另请参见：

received_exception_id()

received_exception_id

String received_exception_id()

返回要返回给客户端的异常的存储库标识。

另请参见：

received_exception()， PortableInterceptor package comments for limitations / unimplemented features

get_effective_component

TaggedComponent get_effective_component(int id)

返回与给定的ID从选定的这个请求的轮廓 IOP.TaggedComponent。

如果一个给定组件标识的多个组件，则此操作返回的组件是未定义的。如果有一个以上的组件对于一个给定的组件ID，get_effective_components应该叫代替。

参数

id -这是要返回的部件ID。

结果

与给定的标识符取得 IOP.TaggedComponent。

异常

BAD_PARAM -扔，一个标准的小代码28，如果ID.没有给定组件组件的存在

另请参见：

get_effective_components(int)

get_effective_components

TaggedComponent[] get_effective_components(int id)

从所选择的配置文件中返回给定的标识的所有标记组件的数组。

参数

id -这是组件返回组件ID。

结果

对 TaggedComponent对象的数组，其中包含给定的标识符。

异常

BAD_PARAM -扔，一个标准的小代码28，如果ID.没有给定组件组件的存在

另请参见：

get_effective_component(int)

get_request_policy

Policy get_request_policy(int type)

返回此操作的效果的给定策略。

参数

type的政策类型，指定要返回的政策。

结果

用给定的类型得到了 CORBA.Policy。

异常

INV_POLICY -扔，一个标准的小代码1，如果政策类型无效是因为指定的类型不支持这个球或者因为该类型是不是与此对象相关的政策目标

另请参见：

PortableInterceptor package comments for limitations / unimplemented features

add_request_service_context

void add_request_service_context(ServiceContext service_context,
                                 boolean replace)

允许拦截器添加服务上下文的要求。

没有服务上下文的顺序的声明。他们可能或可能不会出现在他们被添加的顺序。

参数

service_context - IOP.ServiceContext被添加到请求。

replace -表示该操作行为在服务上下文已经存在与给定的ID。如果为假，那么 BAD_INV_ORDER与标准的小代码15被。如果是真的，那么现有的服务上下文将被新的服务上下文所取代。