软件包 org.omg.CORBA

请参见：
          描述

软件包 org.omg.CORBA 的描述

提供 OMG CORBA API 到 Java^TM 编程语言的映射，包括 ORB 类，如果已实现该类，则程序员可以使用此类作为全功能对象请求代理（Object Request Broker，ORB）。

有关 Java[TM] Platform，Standard Edition 6 遵守的受支持官方 CORBA 规范部分的明确列表，请参阅 Official Specifications for CORBA support in Java[TM] SE 6。

常规信息

这一节中描述的类和接口可分为四组：ORB 类、异常、Helper 类和 Holder 类。

ORB 类

ORB 处理（或代理）客户端与服务器上的方法实现之间的方法调用。因为客户端和服务器可能位于网络的任何地方，调用和实现可能以不同的编程语言编写，所以 ORB 在后台做了很多工作来实现此通信。

ORB 所做的大部分工作对于用户而言是完全透明的，CORBA 包的主要部分由 ORB 在后台使用的类组成。因此大部分程序员将只直接使用此包的一小部分。实际上，大多数程序员仅使用 ORB 类和一些异常中的少数方法，偶尔也使用 holder 类中的少数方法。

ORB 方法

在应用程序进入 CORBA 环境之前，它必须先执行以下操作：

• 被初始化为 ORB 环境，也可能是对象适配器 (POA) 环境。
• 获取对 ORB 对象的引用（在以后的 ORB 操作中使用），也可能获取对其他对象（包括根 POA 或一些 Object Adapter 对象）的引用。

提供以下操作来初始化应用程序及获得适当的对象引用：

• 这一节中将讨论的可访问 ORB 的操作。
• 可访问 Object Adapter、Interface Repository、Naming Service 和其他 Object Service 的操作。这些操作将在其他类 中描述。

当应用程序需要 CORBA 环境时，它需要一个机制来获取 ORB 对象引用，也可能是 OA 对象引用（比如根 POA）。此机制有两个用途。第一个用途是将应用程序初始化为 ORB 和 OA 环境。第二个用途是将 ORB 对象引用和 OA 对象引用返回给应用程序，以便在以后的 ORB 和 OA 操作中使用。

若要获取 ORB 对象引用，应用程序应调用 ORB.init 操作。该调用的参数可能由 ORB 的标识符和 arg_list 组成，前者是对象引用所需要的，后者用于允许将特定于环境的数据传递给调用。

以下 ORB 方法可以访问 ORB：

• init()
• init(String [] args, Properties props)
• init(Applet app, Properties props)

使用不带参数的 init() 方法可以实例化一个单件 ORB，它只能为创建 typecode 提供 any，在通过 idlj 在 Helper 类中生成的代码中需要这些 any。

应用程序需要一个用来获得其初始对象引用的可移植方法。根 POA、POA Current、Interface Repository 和各种 Object Service 实例都需要引用。应用程序所需的功能类似于 Naming Service 提供的那些功能。但是，OMG 不应该要求 Naming Service 可用于所有应用程序以便能够以可移植方式初始化。因此，这一节中展示的操作提供了一个简化的本地 Naming Service，应用程序可以使用它来获取其操作所必须的一小组已定义对象引用。因为只期望从此机制中获得一小组定义良好的对象，所以命名上下文可能被简化为单一级别的名称空间。这种简化的结果是只定义两个操作来获得所需的功能。

初始引用是通过 ORB 对象接口中提供的两个操作获得的，该接口中提供了一些设施来列出并解析初始对象引用。这些工具包括：

• resolve_initial_references(String name)
• list_initial_services()
• register_initial_reference(String id, org.omg.CORBA.Object obj)

使用其中一些方法的示例见 Java IDL 入门。

异常

关于 Java IDL 异常 的文档中有更多信息，这些文档解释了系统异常和用户定义异常之间的不同。

以下是包 org.omg.CORBA 中定义的系统异常的列表（这些异常是通过 org.omg.CORBA.SystemException 从 java.lang.RuntimeException 中继承的未经检查异常）：

        BAD_CONTEXT
        BAD_INV_ORDER
        BAD_OPERATION
        BAD_PARAM
        BAD_TYPECODE
        COMM_FAILURE
        DATA_CONVERSION
        FREE_MEM
        IMP_LIMIT
        INITIALIZE
        INTERNAL
        INTF_REPOS
        INVALID_TRANSACTION
        INV_FLAG
        INV_IDENT
        INV_OBJREF
        INV_POLICY
        MARSHAL
        NO_IMPLEMENT
        NO_MEMORY
        NO_PERMISSION
        NO_RESOURCES
        NO_RESPONSE
        OBJECT_NOT_EXIST
        OBJ_ADAPTER
        PERSIST_STORE
        TRANSACTION_REQUIRED
        TRANSACTION_ROLLEDBACK
        TRANSIENT
        UNKNOWN

以下是包 org.omg.CORBA 中定义的用户定义异常的列表。

        Bounds
        UnknownUserException
        WrongTransaction 
        PolicyError

子包

例如，包 org.omg.CORBA.TypeCodePackage 包含两个由 TypeCode 类中的方法抛出的异常。这些异常包括：

• BadKind
• Bounds

• InvalidName
• InconsistentTypeCode

另一个 CORBA 的子包是 portable 包。该包提供了一组 ORB API，这些 API 使得某个供应商的 IDL 编译器所生成的代码能够在另一个供应商的 ORB 上运行。

Holder 类

支持 out 和 inout 参数传递模式需要使用附加 holder 类。因为 Java 编程语言不支持 out 或 inout 参数，holder 类便作为一种可修改的传递参数方式出现。为了支持可移植 stub 和 skeleton，holder 类还实现了 org.omg.CORBA.portable.Streamable 接口。

Holder 类是通过将 "Holder" 追加到类型名称中来命名的。类型名称是指它在 Java 编程语言中的名称。例如，在 Java 编程语言中名为 Account 的接口所对应的 holder 类应该命名为 AccountHolder。

Holder 类可用于 org.omg.CORBA 包中的所有基本 IDL 数据类型。因此，对于 LongHolder、ShortHolder、FloatHolder 等，都已经定义了相应的类。对于所有已命名用户定义的 IDL 类型（typedef 定义的除外），同样会生成一些类。（注意，在这种情况下，用户定义类型包括那些在 OMG 规范中定义的类型（如用于 Interface Repository 的那些类型）和其他 OMG 服务。）

每个 holder 类都包含：

• 实例中的构造方法
• 默认构造方法
• 公共实例成员，类型化值的 value
• 用来读取输入流并将内容分配给类型的 value 字段的方法
• 用来将 value 字段的值写入输出流的方法
• 用来获取类型的 typecode 的方法

对于 Java 语言定义的类型，默认构造方法将 value 字段设置为以下默认值：

• false，用于 boolean 值
• 0，用于 numeric 和 char 类型
• null，用于字符串和对象引用

举例来说，如果用 OMG IDL 定义的 Account 接口被映射到 Java 编程语言，则将生成以下 holder 类：

public final class AccountHolder implements 
    org.omg.CORBA.portable.Streamable
{
  // field that holds an Account object
  public Account value = null;

  // default constructor
  public AccountHolder ()
  {
  }
  
  // creates a new AccountHolder from initialValue
  public AccountHolder (Account initialValue)
  {
    value = initialValue;
  }
  
  // reads the contents of i and assigns the contents to value
  public void _read (org.omg.CORBA.portable.InputStream i)
  {
    value = AccountHelper.read (i);
  }

  // writes value to o
  public void _write (org.omg.CORBA.portable.OutputStream o)
  {
    AccountHelper.write (o, value);
  }
 
  // returns the typecode for Account
  public org.omg.CORBA.TypeCode _type ()
  {
    return AccountHelper.type ();
  }

}

关于 Holder 类的更多信息，请参阅 OMG IDL to Java Language Mapping 中的第 1.4 章 Mapping for Basic Types。org.omg.CORBA 包中定义的 Holder 类有：

     AnyHolder
     AnySeqHolder
     BooleanHolder
     BooleanSeqHolder
     ByteHolder
     CharHolder
     CharSeqHolder
     CurrentHolder
     DoubleHolder
     DoubleSeqHolder
     FixedHolder
     FloatHolder
     FloatSeqHolder
     IntHolder
     LongHolder
     LongLongSeqHolder
     LongSeqHolder
     ObjectHolder
     OctetSeqHolder
     ParameterModeHolder
     PolicyErrorHolder
     PolicyListHolder
     PrincipalHolder
     ServiceInformationHolder
     ShortHolder
     ShortSeqHolder
     StringHolder
     StringSeqHolder
     TypeCodeHolder
     ULongLongSeqHolder
     ULongSeqHolder
     UnknownUserExceptionHolder
     UShortSeqHolder
     ValueBaseHolder
     WCharSeqHolder
     WrongTransactionHolder
     WStringSeqHolder

Helper 类

Helper 文件提供了一些操作类型所需的静态方法。这些操作包括：

• 对类型进行的 Any 插入和析取操作
• 获取存储库 id
• 获取 typecode
• 在流中读取和写入类型
• 实现 ValueHelper 接口（如果它是用户定义的 value 类型）

用于映射的 IDL 接口或抽象接口的 helper 类还包括收缩操作。静态收缩方法允许将 org.omg.CORBA.Object 收缩成更具体的某种类型的对象引用。如果因为该对象引用不支持所请求的类型而导致收缩失败，则将抛出 IDL 异常 CORBA.BAD_PARAM。引发不同的系统异常则指示存在其他种类的错误。尝试收缩 null 将总是可以成功，并返回 null 值。通常，应用程序编程人员唯一使用的 helper 方法是 narrow 方法。其他方法通常在后台使用，它们对于程序员是透明的。

Helper 类分为两大类，即用于 value 类型的 helper 和用于非 value 类型的 helper。因为一种类别中的所有 helper 类提供的都是相同的方法，所以这里只提供每种 helper 类的一般性解释。

在将 OMG IDL 映射到 Java 编程语言时，为每个用户定义的类型生成一个 "helper" 类。生成的这个类将具有用户定义类型的名称以及追加的 Helper 后缀。例如，如果接口 Account 是用 OMG IDL 定义的，则 idlj 编译器将自动生成一个名为 AccountHelper 的类。AccountHelper 类将包含操作类型实例所需的静态方法，这里的实例指 Account 对象。

narrow 方法

narrow 方法有两种形式，一种形式带有一个 org.omg.CORBA.Object 对象，另一种形式带有一个 java.lang.Object 对象。根据该接口是否是抽象的来确定其 helper 类将提供哪一种 narrow 方法。用于非抽象接口的 helper 类将有一个带 CORBA 对象的 narrow 方法，而用于抽象接口的 narrow 方法将带有 Java 编程语言中的一个对象。对于至少有一个抽象基本接口的非抽象接口，helper 类将同时提供两种形式的 narrow 方法。

Hello World 教程使用的 narrow 方法如下所示：

        // create and initialize the ORB
        ORB orb = ORB.init(args, null);

        // get the root naming context
        org.omg.CORBA.Object objRef = 
            orb.resolve_initial_references("NameService");
        // Use NamingContextExt instead of NamingContext.This is 
        // part of latest Inter-Operable naming Service.  
        NamingContextExt ncRef = NamingContextExtHelper.narrow(objRef);
 
        // resolve the Object Reference in Naming
String name = "Hello";
        helloImpl = HelloHelper.narrow(ncRef.resolve_str(name));

基本 Helper 类的示例

例如，假设接口 Account 不是一个 value 类型的 IDL 类型也不是一个抽象接口，并且没有抽象基本接口，则其 AccountHelper 类将如下所示：

abstract public class AccountHelper
{
  private static String  _id = "IDL:Account:1.0";

  // inserts an Account object into an Any object
  public static void insert (org.omg.CORBA.Any a, Account that)
  {
    org.omg.CORBA.portable.OutputStream out = a.create_output_stream ();
a.type (type ());
    write (out, that);
    a.read_value (out.create_input_stream (), type ());
  }

  // extracts an Account object from an Any object
  public static Account extract (org.omg.CORBA.Any a)
  {
    return read (a.create_input_stream ());
  }

  
  private static org.omg.CORBA.TypeCode __typeCode = null;
  // gets the typecode for this type
  synchronized public static org.omg.CORBA.TypeCode type ()
  {
    if (__typeCode == null)
    {
      __typeCode = org.omg.CORBA.ORB.init ().create_interface_tc (AccountHelper.id (), "Account");
    }
    return __typeCode;
  }

  // gets the repository id for this type
  public static String id ()
  {
    return _id;
  }

  // reads an Account object from an input stream
  public static Account read (org.omg.CORBA.portable.InputStream istream)
  {
    return narrow (istream.read_Object (_AccountStub.class));
  }

  // writes an Account object to an outputstream
  public static void write (org.omg.CORBA.portable.OutputStream ostream, Account value)
  {
    ostream.write_Object ((org.omg.CORBA.Object) value);
  }

  // converts (narrows) an Object to an Account object
  public static Account narrow (org.omg.CORBA.Object obj)
  {
    if (obj == null)
return null;
    else if (obj instanceof Account)
      return (Account)obj;
    else if (!obj._is_a (id ()))
      throw new org.omg.CORBA.BAD_PARAM ();
    else
    {
      org.omg.CORBA.portable.Delegate delegate = ((org.omg.CORBA.portable.ObjectImpl)obj)._get_delegate ();
      _AccountStub stub = new _AccountStub ();
      stub._set_delegate(delegate);
      return stub;
    }
  }

}

value 类型 Helper 类

假设 Address 是 value 类型，则 AddressHelper 类将如下所示：

abstract public class AddressHelper
{
  private static String  _id = "IDL:Address:1.0";

  // same as for non-value type
  public static void insert (org.omg.CORBA.Any a, Address that)
  {
    org.omg.CORBA.portable.OutputStream out = a.create_output_stream ();
a.type (type ());
    write (out, that);
    a.read_value (out.create_input_stream (), type ());
  }

  // same as for non-value type
  public static Address extract (org.omg.CORBA.Any a)
  {
    return read (a.create_input_stream ());
  }

  private static org.omg.CORBA.TypeCode __typeCode = null;
  private static boolean __active = false;
  
  // getting the typecode for the type
  synchronized public static org.omg.CORBA.TypeCode type ()
  {
    if (__typeCode == null)
    {
      synchronized (org.omg.CORBA.TypeCode.class)
      {
        if (__typeCode == null)
        {
          if (__active)
          {
            return org.omg.CORBA.ORB.init().create_recursive_tc ( _id );
          }
__active = true;
          org.omg.CORBA.ValueMember[] _members0 = new org.omg.CORBA.ValueMember[0];
          org.omg.CORBA.TypeCode _tcOf_members0 = null;
          __typeCode = org.omg.CORBA.ORB.init ().create_value_tc (_id, "Address", org.omg.CORBA.VM_NONE.value, null, _members0);
__active = false;
        }
      }
    }
    return __typeCode;
  }

  // same as for non-value type
  public static String id ()
  {
    return _id;
  }

  // reads a serializable instance of Address from the given input stream
  public static Address read (org.omg.CORBA.portable.InputStream istream)
  {
    return (Address)((org.omg.CORBA_2_3.portable.InputStream) istream).read_value (id ());
  }

  // writes a serializable instance of Address to the given output stream
  public static void write (org.omg.CORBA.portable.OutputStream ostream, Address value)
  {
    ((org.omg.CORBA_2_3.portable.OutputStream) ostream).write_value (value, id ());
  }


}

org.omg.CORBA 包中定义的 Helper 类有：

     AnySeqHelper
     BooleanSeqHelper
     CharSeqHelper
     CompletionStatusHelper
     CurrentHelper
     DefinitionKindHelper
     DoubleSeqHelper
     FieldNameHelper
     FloatSeqHelper
     IdentifierHelper
     IDLTypeHelper
     LongLongSeqHelper
     LongSeqHelper
     NameValuePairHelper
     ObjectHelper
     OctetSeqHelper
     ParameterModeHelper
     PolicyErrorCodeHelper
     PolicyErrorHelper
     PolicyHelper
     PolicyListHelper
     PolicyTypeHelper
     RepositoryIdHelper
     ServiceDetailHelper
     ServiceInformationHelper
     SetOverrideTypeHelper
     ShortSeqHelper
     StringSeqHelper
     StringValueHelper
     StructMemberHelper
     ULongLongSeqHelper
     ULongSeqHelper
     UnionMemberHelper
     UnknownUserExceptionHelper
     UShortSeqHelper
     ValueBaseHelper
     ValueMemberHelper
     VersionSpecHelper
     VisibilityHelper
     WCharSeqHelper
     WrongTransactionHelper
     WStringSeqHelper
     WStringValueHelper

其他类

ORB 创建的类

• TCKind -- 指示 TypeCode 对象的种类（数据类型）
• TypeCode -- 指示数据类型，可能包括其他信息
• Any -- 包含一个值及其 typecode
• NamedValue -- 包含一个名称、一个 Any 对象和一个参数模式标志。NamedValue 对象包含关于方法参数、方法返回值或一个上下文的信息。
• ContextList -- 一个字符串列表，这些字符串描述需要被解析并随调用发送的上下文
• ExceptionList -- 一个 TypeCode 列表，这些 TypeCode 用于可能由某一方法抛出的异常
• Environment -- 方法调用期间抛出的异常的容器
• Context -- 一个 NamedValue 对象列表，这些对象用来将辅助信息从客户端传递到服务器
• NVList -- 一个 NamedValue 对象列表，这些对象用于传递参数或获取结果

处理请求的类

• Object -- 所有 CORBA 对象引用的基类
• Request -- DII 中的主要类，它包含各种方法，有些用来给请求添加参数，有些用来访问有关被调用方法的信息（方法的名称、参数、抛出的异常等等），还有些用来对请求执行调用
• DynamicImplementation -- 用于使用 DSI 的服务器实现的基类。它包含方法 invoke，此类的一个实现可使用该方法确定 ServerRequest 对象的状态并设置其结果或异常
• ServerRequest -- 捕获针对动态框架接口 (Dynamic Skeleton Interface) 的请求的显式状态

用作常量的接口

这就是为什么 org.omg.CORBA 包中的几个接口包含一个 value 字段的原因，该字段是一个 short 值。此字段是一个用于错误代码或值修饰符之类的常量。例如，BAD_POLICY 接口的 value 字段可能是抛出 PolicyError 异常的原因之一。要指定此错误代码，应使用 BAD_POLICY.value。

PolicyError 异常使用以下接口的 value 字段作为其可能的错误代码。

• BAD_POLICY
• BAD_POLICY_TYPE
• BAD_POLICY_VALUE
• UNSUPPORTED_POLICY
• UNSUPPORTED_POLICY_VALUE

• VM_NONE
• VM_ABSTRACT
• VM_CUSTOM
• VM_TRUNCATABLE

• PRIVATE_MEMBER
• PUBLIC_MEMBER

• ARG_IN
• ARG_INOUT
• ARG_OUT
• CTX_RESTRICT_SCOPE

Interface Repository 接口和类

ORB 不需要接口存储库，Java IDL 也不包含接口存储库。尽管此版本不包括接口存储库的实现，但它包含以下 IR 类和接口，以创建 typecodes（参见 org.omg.CORBA.ORB 接口中的 create_value_tc、create_struct_tc、create_union_tc 和 create_exception_tc 方法）：
&nbs

• IRObject
• IDLType
• DefinitionKind
• StructMember
• UnionMember
• ValueMember

相关文档

• Java IDL 主页

Java IDL 中没有实现的 CORBA 特性

org.omg 子包中包含的一些 API 是为了与当前 OMG CORBA 规范保持一致而提供的，但 Sun 的 JDK^TM 版本中没有实现它们。这使得其他 JDK 被许可人可以在标准扩展和产品中提供此 API 的实现。

抛出 NO_IMPLEMENT 的特性

org.omg 子包中包含的一些 API 会因为各种原因抛出 NO_IMPLEMENT 异常。其中一些原因是：

• 在某些情况下，完成实现根据规范指示这些 API 应抛出 NO_IMPLEMENT，例如 LocalObject。

• 在多数情况下，抛出 NO_IMPLEMENT 的方法实际上是在 ORB 代码中其他某个地方的子类中实现的，例如 ORB.java 中的方法。

• 在某些情况下，API 确实尚未实现，例如 _get_interface_def() 和 _get_interface。

此版本中未实现的特性和 API 的总结：

• Interface Repository。Java IDL 的常规操作不需要 Interface Repository。
• Java IDL 不支持 long double。
• 策略 (org.omg.CORBA.Policy) 及获取这些策略的方法未实现。
• 域管理器 (org.omg.CORBA.DomainManager) 及获取这些域管理器的方法未实现。
• 服务信息 org.omg.CORBA.ServiceInformation 和 ORB 方法 public boolean get_service_information(short service_type, ServiceInformationHolder service_info) 未实现。
• 支持单线程的 ORB 方法（perform_work 和 work_pending）未实现。
• IDL 上下文。

org.omg.CORBA 包中未实现特性的详细列表

org.omg.CORBA 包中未实现的方法：

• ORB
  • public org.omg.CORBA.Policy create_policy(int type, org.omg.CORBA.Any val)
  • public void perform_work()
  • public boolean work_pending()
  • public org.omg.CORBA.Current get_current()
  • create_operation_list
  • get_default_context
  • get_service_information
  • 废弃 DynAny（推荐使用 DynamicAny 包替代）

从以下版本开始：

JDK1.2

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