Java 软件包 org.omg.PortableServer（JDK5）

所有类

软件包 org.omg.PortableServer

请参见：
          描述

软件包 org.omg.PortableServer 的描述

提供一些类和接口，用来生成跨多个供应商 ORB 的可移植应用程序的服务器端。

在 Java 中，基于可移植对象适配器（Portable Object Adaptor，POA）的动态框架接口（Dynamic Skeleton Interface，DSI）servant 继承自标准 DynamicImplementation 类，而该类继承自 Servant 类。本机 Servant 类型由 POA 的 PortableServer 模块定义。在 Java 中，Servant 类型被映射到 Java org.omg.PortableServer.Servant 类。它充当所有 POA servant 实现的基类，提供许多可由应用程序员调用的方法，以及可由 POA 本身调用（也可由用户重写）以控制 servant 行为各方面的方法。

包规范

有关 Java 2 平台、标准版 v.1.4 遵守的官方 OMG 规范的受支持部分的明确列表，请参阅 Official Specifications for CORBA support in J2SE 1.4。

与 POA 相关的接口

PortableServer 模块定义以下与 POA 相关的接口：

• POA
• POAManager
• ServantManager
• ServantActivator
• ServantLocator
• AdapterActivator
• ThreadPolicy
• LifespanPolicy
• IdUniquenessPolicy
• IdAssignmentPolicy
• ImplicitActivationPolicy
• ServantRetentionPolicy
• RequestProcessingPolicy
• Current

此外，POA 还定义 Servant 本机类型。

操作类

上文列出的每个接口都有一个关联的 Operations 接口。Operations 接口由 idlj 编译器生成，其中包含一些方法签名，用于在与其关联的接口中定义的方法。Operations 接口可以通过客户端和服务器访问，而其关联的接口只能通过客户端调用。

值类

• IdAssignmentPolicyValue
• IdUniquenessPolicyValue
• ImplicitActivationPolicyValue
• LifespanPolicyValue
• RequestProcessingPolicyValue
• ServantRetentionPolicyValue
• ThreadPolicyValue

Helper 类

Helper 类是为 OMG IDL 接口中所有用户定义类型生成的，提供操作这些类型所需的静态方法。Helper 类中只有一种供应用程序员使用的方法。narrow 方法。只有 IDL 接口所映射的 Java 接口才有包含 narrow 方法的 helper 类，因此在 PortableServer 包中，只有以下类才具有 narrow 方法：

• ForwardRequestHelper
• ServantActivatorHelper
• ServantLocatorHelper

POA 类

POA 类用于实现 ServantActivator 或 ServantLocator。

异常

ForwardRequest 异常指示 ORB 负责将当前请求和后续 ForwardRequest 请求传递给异常的 forward_reference 成员所表示的对象。

应用程序员所实现的接口

PortableServer 执行的大部分操作对用户是透明的。因此程序员将只能使用一小部分上述接口。剩余的接口将由 ORB 实现提供。应用程序员所需的接口如下：

• AdapterActivator

  适配器激活器与 POA 关联。适配器激活器提供具有随需创建子 POA 功能的 POA。产生这一需求可能是接受指定子 POA（或其中一个子 POA）的请求所带来的副作用，调用 find_POA 时将 activate 参数值设置为 TRUE 也需要创建子 POA。创建所有所需 POA 的应用服务器在刚开始执行时不需要使用或提供适配器激活器；只有在请求处理期间需要创建 POA 时才有必要这样做。

• ServantLocator

  当 POA 具有 NON_RETAIN 策略时，使用 ServantLocator 这种 servant 管理器。

• ServantActivator

  当 POA 具有 RETAIN 策略时，使用 ServantActivator 这种 servant 管理器。

org.omg.PortableServer.ServantLocatorPackage 包

此包提供一个 CookieHolder 类，将 Cookie 类型作为 out 参数传递。CookieHolder 类与其他基本类型的 holder 类完全一样。

相关文档

有关 Java IDL 概述，请参见：

import javax.naming.InitialContext;
import javax.naming.Context;
import javax.rmi.PortableRemoteObject ;
import com.sun.corba.se.impl.poa.POAORB;
import org.omg.PortableServer.*;
import java.util.*;
import org.omg.CORBA.*;
import javax.rmi.CORBA.Stub;
import javax.rmi.CORBA.Util;



public class HelloServer {
    public HelloServer(String[] args) {
        try {
            Properties p = System.getProperties();
         //   p.put("org.omg.CORBA.ORBClass", "com.sun.corba.ee.internal.POA.POAORB");
            ORB orb = ORB.init( args, p );

            POA rootPOA = (POA)orb.resolve_initial_references("RootPOA");

Policy[] tpolicy = new Policy[3];
            tpolicy[0] = rootPOA.create_lifespan_policy(
                LifespanPolicyValue.TRANSIENT );
            tpolicy[1] = rootPOA.create_request_processing_policy(
                RequestProcessingPolicyValue.USE_ACTIVE_OBJECT_MAP_ONLY );
            tpolicy[2] = rootPOA.create_servant_retention_policy(
                ServantRetentionPolicyValue.RETAIN);
            POA tpoa = rootPOA.create_POA("MyTransientPOA", null, tpolicy);


            String  ObjectId = "MyObjectId";
            byte[] oid = ObjectId.getBytes();

            org.omg.CORBA.Object obj = tpoa.create_reference_with_id(oid,
                new _HelloImpl_Tie()._all_interfaces(tpoa, oid)[0]);
            HelloInterface helloRef = (HelloInterface)PortableRemoteObject.narrow(
                obj, HelloInterface.class );

            Context initialNamingContext = new InitialContext();
            initialNamingContext.rebind("HelloService", helloRef);
            System.out.println("Hello Server: Ready...");
            orb.run();
         } catch (Exception e) {
            System.out.println("Trouble:" + e);
            e.printStackTrace();
         } 
     }


     public static void main(String args[]) {
         new HelloServer( args );
     }
}