当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

ORBInitInfoOperations (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

org.omg.PortableInterceptor
接口 ORBInitInfoOperations

所有已知子接口：

ORBInitInfo

---

public interface ORBInitInfoOperations

传递给每个 ORBInitializer，允许其在初始化 ORB 时注册 interceptor 并执行其他职责。

ORBInitInfo 对象只在 ORB.init 期间有效。如果服务保持对其 ORBInitInfo 对象的引用，并试图在 ORB.init 返回后使用该对象，则该对象将不再存在，并抛出 OBJECT_NOT_EXIST 异常。

另请参见：

ORBInitializer

---

方法摘要
void	add_client_request_interceptor(ClientRequestInterceptor interceptor)           此方法用来将客户端的请求 Interceptor 添加到客户端请求 Interceptor 列表。
void	add_ior_interceptor(IORInterceptor interceptor)           此方法用来将 IOR Interceptor 添加到 IOR Interceptor 列表。
void	add_server_request_interceptor(ServerRequestInterceptor interceptor)           此方法用来将服务器端的请求 Interceptor 添加到服务器端请求 Interceptor 列表。
int	allocate_slot_id()           调用此方法来在 PortableInterceptor.Current 上分配槽 (slot)。
String[]	arguments()           返回传递给 ORB.init 的参数。
CodecFactory	codec_factory()           返回 IOP.CodecFactory。
String	orb_id()           返回将被初始化的 ORB 的 ID。
void	register_initial_reference(String id, Object obj)           等同于 ORB.register_initial_reference。
void	register_policy_factory(int type, PolicyFactory policy_factory)           注册给定 PolicyType 的 PolicyFactory。
Object	resolve_initial_references(String id)           等同于 ORB.resolve_initial_references。

 

方法详细信息

arguments

String[] arguments()

返回传递给 ORB.init 的参数。它们可能包含 ORB 的参数，也可能不包含。

---

orb_id

String orb_id()

返回将被初始化的 ORB 的 ID。

---

codec_factory

CodecFactory codec_factory()

返回 IOP.CodecFactory。通常通过调用 ORB.resolve_initial_references( "CodecFactory" ) 获取 CodecFactory，但是因为 ORB 当前不可用，而且 Interceptor（尤其是在处理服务上下文时）将请求 Codec，所以必须在初始化 ORB 时获取 Codec 的方法。

---

register_initial_reference

void register_initial_reference(String id,
                                Object obj)
                                throws InvalidName

等同于 ORB.register_initial_reference。这里提供一个具有相同功能的方法是因为：未完全初始化的 ORB 当前不可用，但是初始引用可能需要作为 Interceptor 注册的一部分被注册。唯一的不同之处在于，ORB 中的这一操作使用 PIDL (CORBA.ORB.ObjectId) 和 (CORBA.ORB.InvalidName)，而此接口中的这一操作使用此接口中定义的 IDL；语义是等同的。

抛出：

InvalidName

---

resolve_initial_references

Object resolve_initial_references(String id)
                                  throws InvalidName

等同于 ORB.resolve_initial_references。这里提供一个具有相同功能的方法是因为：未完全初始化的 ORB 当前不可用，但是 ORB 中的初始引用可能需要作为 Interceptor 注册的一部分。唯一的不同之处在于，ORB 中的这一操作使用 PIDL (CORBA::ORB::ObjectId) 和 (CORBA::ORB::InvalidName)，而此接口中的这一操作使用此接口中定义的 IDL；语义是等同的。

此操作仅在 post_init 期间有效。

抛出：

InvalidName

---

add_client_request_interceptor

void add_client_request_interceptor(ClientRequestInterceptor interceptor)
                                    throws DuplicateName

此方法用来将客户端的请求 Interceptor 添加到客户端请求 Interceptor 列表。

参数：

interceptor - 要添加的 ClientRequestInterceptor。

抛出：

DuplicateName - 如果客户端的请求 Interceptor 已经使用此 Interceptor 的名称注册。

---

add_server_request_interceptor

void add_server_request_interceptor(ServerRequestInterceptor interceptor)
                                    throws DuplicateName

此方法用来将服务器端的请求 Interceptor 添加到服务器端请求 Interceptor 列表。

参数：

interceptor - 要添加的 ServerRequestInterceptor。

抛出：

DuplicateName - 如果服务器端的请求 Interceptor 已经使用此 Interceptor 的名称注册。

---

add_ior_interceptor

void add_ior_interceptor(IORInterceptor interceptor)
                         throws DuplicateName

此方法用来将 IOR Interceptor 添加到 IOR Interceptor 列表。

参数：

interceptor - 要添加的 IORInterceptor。

抛出：

DuplicateName - 如果 IOR Interceptor 已经使用此 Interceptor 名称注册。

---

allocate_slot_id

int allocate_slot_id()

调用此方法来在 PortableInterceptor.Current 上分配槽 (slot)。

注意，可以在 ORB 初始化程序中分配槽的 id，但不能初始化槽本身。

返回：

已经分配的槽的索引。

抛出：

BAD_INV_ORDER - 如果在 ORB 初始化程序内对 PICurrent 调用 set_slot 或 get_slot，则抛出此异常并带有标准次要代码 14。

另请参见：

Current

---

register_policy_factory

void register_policy_factory(int type,
                             PolicyFactory policy_factory)

注册给定 PolicyType 的 PolicyFactory。

参数：

type - 给定 PolicyFactory 服务的策略类型。

policy_factory - 给定策略类型的工厂。

抛出：

BAD_INV_ORDER - 如果已经存在给定 PolicyType 的 PolicyFactory，则抛出此异常并带有标准次要代码 16。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。