org.omg.PortableInterceptor

Interface ORBInitializerOperations

All Known Subinterfaces:

ORBInitializer

public interface ORBInitializerOperations

方便拦截器注册和ORB初始化。

拦截器旨在成为ORB服务获得ORB处理的一种手段，有效地成为ORB的一部分。 由于拦截器是ORB的一部分，当ORB.init返回ORB时，拦截器已被注册。 在通过电话ORB.init返回后，拦截器无法在ORB上ORB.init 。

通过注册实现ORBInitializer接口的相关联的ORBInitializer对象来注册ORBInitializer器。 当在初始化ORB，应当调用每个注册ORBInitializer ，传递一个ORBInitInfo其用于登记其拦截器对象。

在Java中注册ORB初始化器

ORBInitializers通过Java ORB属性注册。

财产名称的格式如下：

org.omg.PortableInterceptor.ORBInitializerClass.<Service>

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

org.omg.PortableInterceptor.ORBInitializer

为避免名称冲突，应使用反向DNS名称约定。 例如，如果X公司有三个初始化器，它可以定义以下属性：

• 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开头的ORB属性， <Service>每个属性的<Service>部分，对象应以<Service>字符串作为其类别名称进行pre_init ，并应调用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

关于注册拦截器的注意事项

请求拦截器以每ORB的形式进行注册。

要实现虚拟的每个对象拦截器，从截取点内查询目标上的策略，以确定它们是否应该做任何工作。

为了实现虚拟的每个POA拦截器，用不同的ORB实例化每个POA。 虽然拦截器可能被行政命令，但是关于拦截器的注册没有关于秩序的概念。 请求拦截器涉及服务环境。 服务上下文没有任何命令，因此请求拦截器无需订单。 IOR拦截器涉及标记的组件。 标签组件也没有任何命令，因此IOR Interceptor不能有订单。

注册代码应该避免使用ORB（即，主叫ORB.init与所提供的orb_id ）。 由于在ORB初始化期间发生注册，因此在此ORB处于此状态时调用的结果未定义。

另请参见：

ORBInitInfo

方法摘要

Modifier and Type	Method and Description
void	post_init(ORBInitInfo info) 在ORB初始化期间调用。
void	pre_init(ORBInitInfo info) 在ORB初始化期间调用。

方法详细信息

pre_init

void pre_init(ORBInitInfo info)

在ORB初始化期间调用。 如果期望由拦截器注册的初始服务将被其他拦截器使用，那么这些初始服务应通过呼叫ORBInitInfo.register_initial_reference在此ORBInitInfo.register_initial_reference 。

参数

info - 提供可以注册拦截器的初始化属性和操作。

post_init

void post_init(ORBInitInfo info)

在ORB初始化期间调用。 如果服务必须在初始化时解析初始引用，那么可以假设所有初始引用在这一点上都可用。

调用post_init操作不是ORB初始化的最终任务。 按照post_init电话的最后一个任务是将已登录拦截器的列表附加到ORB。 因此，在调用post_init期间，ORB不包含post_init 。 如果在post_init内进行了一个ORB调用的调用，那么在该调用中不会调用请求拦截器。 同样，如果执行导致创建IOR的操作，则不会调用IOR拦截器。

参数

info - 提供可以注册拦截器的初始化属性和操作。