ORBInitializerOperations - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

org.omg.PortableInterceptor
接口 ORBInitializerOperations

所有已知子接口：: ORBInitializer

public interface ORBInitializerOperations

便于注册 interceptor 和初始化 ORB。

ORB 服务凭借 Interceptor 这一方法获得进行 ORB 处理的权力，Interceptor 实际上已成为 ORB 的一部分。因为 Interceptor 是 ORB 的一部分，所以当 ORB.init 返回 ORB 时，应该已经注册了 Interceptor。在已经调用 ORB.init 返回 Interceptor 后，不能在 ORB 上注册 Interceptor。

通过注册实现 ORBInitializer 接口的关联的 ORBInitializer 对象才能注册 Interceptor。ORB 在初始化时，应该调用每个已注册 ORBInitializer，并将用来注册其 Interceptor 的 ORBInitInfo 对象传递给该 ORB。

用 Java 注册 ORB Initializer

ORBInitializer 通过 Java ORB 属性注册。

属性名称的形式如下：

org.omg.PortableInterceptor.ORBInitializerClass.<Service>

其中 <Service> 是实现以下类的字符串名称：

org.omg.PortableInterceptor.ORBInitializer

要避免名称冲突，应使用与 DNS 名称约定相反的约定。例如，如果 X 公司有三个 initializer，则它能够定义以下属性：

org.omg.PortableInterceptor.ORBInitializerClass.com.x.Init1
org.omg.PortableInterceptor.ORBInitializerClass.com.x.Init2
org.omg.PortableInterceptor.ORBInitializerClass.com.x.Init3

在 ORB.init 期间，应该收集那些以 org.omg.PortableInterceptor.ORBInitializerClass 开头的属性，提取每个属性的 <Service> 部分，然后将该 <Service> 字符串作为类名来实例化某个对象，并对该对象调用 pre_init 和 post_init 方法。如果存在异常，ORB 应忽略这些异常并继续进行。

示例

例如，X 公司编写的客户端登陆可能具有以下 ORBInitializer 实现：

 package com.x.logging;
 
 import org.omg.PortableInterceptor.Interceptor; 
 import org.omg.PortableInterceptor.ORBInitializer; 
 import org.omg.PortableInterceptor.ORBInitInfo; 
 
 public class LoggingService implements ORBInitializer { 
     void pre_init( ORBInitInfo info ) { 
         // Instantiate the Logging Service s Interceptor. 
         Interceptor interceptor = new LoggingInterceptor(); 

         // Register the Logging Service s Interceptor. 
         info.add_client_request_interceptor( interceptor ); 
     } 
 
     void post_init( ORBInitInfo info ) { 
         // This service does not need two init points. 
     } 
 }

要运行使用此日志记录服务的名为 MyApp 的程序，用户可以键入：

java -Dorg.omg.PortableInterceptor.ORBInitializerClass.com.x.Logging.LoggingService MyApp

注册 Interceptor 的有关注意事项：

每个 ORB 都要注册请求 Interceptor。

要获得虚拟的针对对象的 Interceptor，应在截取点内的目标上查询策略以确定它们是否应该执行某些操作。

要获得虚拟的针对 POA 的 Interceptor，应使用不同的 ORB 实例化每个 POA。虽然在管理上 Interceptor 是有序的，但注册 Interceptor 时并不需要按顺序进行。请求 Interceptor 参与服务上下文。服务上下文没有顺序，因此请求 Interceptor 也没有必要有顺序。IOR Interceptor 参与带标记的组件。带标记的组件没有顺序，因此 IOR Interceptor 也没有必要有顺序。

注册代码应该避免使用 ORB（即使用提供的 orb_id 调用 ORB.init）。因为注册发生在初始化 ORB 期间，对出于此状态的 ORB 进行调用的结果是不确定的。

另请参见：: ORBInitInfo

方法摘要
`void`	`post_init(ORBInitInfo info)` 初始化 ORB 期间调用此方法。
`void`	`pre_init(ORBInitInfo info)` 初始化 ORB 期间调用此方法。

方法详细信息

pre_init

void pre_init(ORBInitInfo info)

初始化 ORB 期间调用此方法。如果希望 interceptor 注册的初始服务可以供其他 interceptor 使用，则应该在此时通过调用 ORBInitInfo.register_initial_reference 注册那些初始服务。

参数：: info - 提供 Interceptor 据以注册的初始化属性和操作。

post_init

void post_init(ORBInitInfo info)

初始化 ORB 期间调用此方法。如果服务必须作为其初始化的一部分解析初始引用，则它应该假定此时所有的初始引用均可用。

调用 post_init 操作并不是初始化 ORB 的最后一项工作。调用 post_init 之后的最后一项工作是将已注册 interceptor 列表附加到 ORB。因此，在调用 post_init 期间，ORB 不包含 interceptor。如果从 post_init 内部进行间接 ORB 调用，则在该调用上不会调用任何请求 interceptor。类似的，如果执行了导致创建 IOR 的操作，也不会调用任何 IOR interceptor。

参数：: info - 提供 Interceptor 据以注册的初始化属性和操作。

概述