javatm platform
standard ed. 6

org.omg.portableinterceptor
接口 requestinfooperations

所有<suǒ yǒu>已知子接口:
clientrequestinfo, clientrequestinfooperations, requestinfo, serverrequestinfo, serverrequestinfooperations

public interface requestinfooperations

interceptor 可访问<visit>的请求信息。

每个截取点都给定了一个对象,interceptor 可以<can>通过该对象访问<visit>请求信息。客户<kè hù>端和服务<services>器端的截取点关注不同的信息,因此<therefore>有两种信息对象:clientrequestinfo 传递给客户<kè hù>端的截取点,serverrequestinfo 传递给服务<services>器端的截取点。但也有两者都需要的信息,所以这两个接口继承自同一个接口:requestinfo

另请参见:
clientrequestinfo,serverrequestinfo

方法摘要
 parameter[]arguments()
          返回一个 parameter 对象数组,包含将调用的操作上的参数。
 string[]contexts()
          返回一个 string 对象数组,这些对象描述可以<can>在此操作调用上传递的上下文。
 typecode[]exceptions()
          返回一个 typecode 对象数组,这些对象描述此操作调用可能<kě néng>抛出的用户异常的 typecode
 objectforward_reference()
          如果 reply_status 属性为 location_forward,则包含要将请求转发到的对象。
 servicecontextjs随机数get_reply_service_context(int id)
          返回具有给定 id 的与应答关联的服务上下文复本。
 servicecontextget_request_service_context(int id)
          返回具有给定 id 的与请求关联的服务上下文复本。
 anyget_slot(int id)
          返回请求域内 portableinterceptor.current 给定槽 (slot) 中的数据。
 string[]operation_context()
          返回一个 string 对象数组,这些对象包含将在请求上发送上下文。
 stringoperation()
          返回将被调用的操作的名称。
 shortreply_status()
          描述操作调用结果的状态。
 intrequest_id()
          返回唯一<sole>地标识激活的请求/应答序列的 id。
 booleanresponse_expected()
          指示是否希望<xī wàng>响应。
 anyresult()
          返回一个 any,它包含该操作调用的结果。
 shortsync_scope()
          定义在控制信息返回到客户端前请求应前进的距离。
 

方法详细校約ense>畔

request_id

int request_id()
返回唯一<sole>地标识激活的请求/应答序列的 id。请求/应答序列一结束<End>此 id 即可重用。注意<危险信号>,此 id 不同于 giop request_id。如果使用的传送机制是 giop,则这些 id 很可能<kě néng>是相同的,但是<dàn shì>不保证也不要<压嘛碟>求如此。


operation

string operation()
返回将被调用的操作的名称。


arguments

parameter[] arguments()
返回一个 parameter 对象数组,包含将调用的操作上的参数。如果没有参数,则此属性将是一个 0 长度< dù>数组。

并非所有环境都提供对参数的访问。例如,使用 java 可移植绑定时参数将不可用。在这些环境中访问此属性时,将抛出 no_resources,并带有标准次要代码 1。

注:对于 dsi/dii 调用参数是可用的。

抛出:
no_resources - 如果参数不可用。
另请参见:
portableinterceptor 包中关于限制/未实现特性的注释

exceptions

typecode[] exceptions()
返回一个 typecode 对象数组,这些对象描述此操作调用可能抛出的用户异常的 typecode。如果没有用户异常,则此方法返回一个长度< dù>为 0 的数组。

并非所有环境都提供对异常列表的访问。例如,使用 java 可移植绑定时异常列表将不可用。在这些环境中访问此属性时,将抛出 no_resources,并带有标准次要代码 1。

注:异常对于 dsi/dii 调用是可用的。

抛出:
no_resources - 如果异常不可用。
另请参见:
portableinterceptor 包中关于限制/未实现特性的注释
米粉商业同业公会理事长郭文铭表示,目前中国<China>有许多<xǔ duō>不肖商人打着新竹米粉的名义进行出口<chū kǒu>,而真正在地的新竹米粉,反而<fǎn ér>碍于国内法令的限制,无法<to be>以
站在四四南村,可以清楚地看到台北的地标101大楼,从四四南村的角度看过去,高入云霄的现代建筑与眼前老式的眷村形成<caused><xíng chéng>了新旧的对比,有一种感受时间流动、历史<History>变迁的奇妙感觉<很爽>
为维护地方传统米粉产业权益,新竹市长林智坚23日北上拜会中央部会官员,他强调<emphasised>,新竹米粉代表的就应该<yīng gāi>是由新竹在地业者生产的米粉,不能任由非新竹地方的业者任意冠名,不仅<not only>造成消费者混淆,更伤害新竹米粉百年历史<History>声誉,
台南市的梅岭在不同的季节<jì jié>有着不一样的美景,除了冬天能欣赏梅花、四到六月能享受赏萤的乐趣,这些热门时节以外的四季也能欣赏高山野百合、紫樱丹、山樱花、艳紫牡丹等

contexts

string[] contexts()
返回一个 string 对象数组,这些对象描述可以在此操作调用上传递的上下文。如果没有上下文,则此方法返回一个长度为 0 的数组。

并非所有环境都提供对上下文列表的访问。例如,使用 java 可移植绑定时上下文列表将不可用。在这些环境中访问此属性时,将抛出 no_resources,并带有标准次要代码 1。

注:上下文对于 dsi/dii 调用是可用的。

抛出:
no_resources - 如果上下文不可用。
另请参见:
portableinterceptor 包中关于限制/未实现特性的注释

operation_context

string[] operation_context()
返回一个 string 对象数组,这些对象包含将在请求上发送上下文。

并非所有环境都提供对上下文的访问。例如,使用 java 可移植绑定时上下文将不可用。在这些环境中访问此属性时,将抛出 no_resources,并带有标准次代码 1。

注:operation_context 对于 dsi/dii 调用是可用的。

抛出:
no_resources - 如果操作上下文不可用。
另请参见:
portableinterceptor 包中关于限制/未实现特性的注释

result

any result()
返回一个 any,它包含该操作调用的结果。如果操作返回类型为空,则此属性将是包含 tckind 值为 tk_void 的类型代码的 any,并且该 any 不包含任何值。

并非所有环境都提供对结果的访问。例如,使用 java 可移植绑定时结果将不可用。在这些环境中访问此属性时,将抛出 no_resources,并带有标准次要代码 1。

注:结果对于 dsi/dii 调用是可用的。

抛出:
no_resources - 如果结果不可用。
另请参见:
portableinterceptor 包中关于限制/未实现特性的注释

response_expected

boolean response_expected()
指示是否希望<xī wàng>响应。

对于客户端,当 response_expected 为 false 时不返回应答,因此<therefore>不能调用 receive_reply。不发生<occasionally occurred>异常时调用 receive_other,发生<occasionally occurred>异常时调用 receive_exception

此属性在客户端 send_poll 内部为 true。


sync_scope

short sync_scope()
定义在控制信息返回到客户端前请求应前进的距离。这已在 messaging 规范中定义,仅当 response_expected 为 false 时才相关。如果 response_expected 为 true,则 sync_scope 的值是不确定的。此属性可以是以下值之一:对于服务器所有的域而言,将从目标操作调用的返回中创建应答,但不会将该应答返回给客户端。尽管它不会返回给客户端,但确实发生了应答,因此将执行正常服务器端截取点(即 receive_request_service_contextsreceive_requestsend_replysend_exception)。

对于 sync_with_serversync_with_target,在调用目标前,服务器将一个空应答发送回客户端。此应答将不会被服务器端的 interceptor 截取。

另请参见:
portableinterceptor 包中关于限制/未实现特性的注释

reply_status

short reply_status()
描述操作调用结果的状态。返回值可以是以下值之一:对于客户端:对于服务器:

另请参见:
successful,system_exception,user_exception,location_forwardjs随机数,transport_retry

forward_reference

object forward_reference()
如果 reply_status 属性为 location_forward,则包含要将请求转发到的对象。转发的请求是否将实际发生是不确定的。


get_slot

any get_slot(int id)   throws invalidslot
返回请求域内 portableinterceptor.current 给定槽 (slot) 中的数据。

如果尚未设置给定槽,则返回一个包含 tckind 值为 tk_null 的类型代码的 any。

参数:
id - 将返回的槽的 slotid网站地图 手机端
返回:
使用给定标识符获取的槽数据,以 any 的形式存在。
抛出:
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。

javatm platform
standard ed. 6

提交错误或意见<yì jian>
有关更多的 api 参考资料和开发<kāi fā>人员文档,请参阅 java se 开发<kāi fā>人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作<gōng zuò>代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策