软件包 org.omg.CosNaming

请参见：
          描述

软件包 org.omg.CosNaming 的描述

为 Java IDL 提供命名服务。对象请求代理守护程序（Object Request Broker Daemon，ORBD）还包括瞬态和持久命名服务。

该包及其所有类和接口都是通过在 nameservice.idl 文件上运行 idlj 工具生成的，该文件是用 OMG IDL 编写的模块。

包规范

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

接口

这两个接口是：

• NamingContext
• BindingIterator

这两个接口提供了一些方法，有些用来绑定/取消绑定名称和对象引用，有些用来检索绑定的对象引用，还有些用来迭代绑定列表。NamingContext 接口提供命名服务的主要功能，BindingIterator 提供迭代名称/对象引用绑定列表的各种方法。

辅助类

NamingContext 和 BindingIterator 所使用的类

• public final class NameComponent - 名称的构建块 (building block)。（名称被绑定到命名上下文中的对象引用。）

  名称是一个或多个 NameComponent 对象所组成的数组。带有单个 NameComponent 的名称称为简单名称；带有多个 NameComponent 对象的名称称为组合名称。

  NameComponent 对象由两个字段组成：

  1. id - 用作标识符的 String
  2. kind - 可用于任何描述性内容的 String。其重要性在于，可以使用它来描述对象，但不会影响到语法。例如，C 编程语言使用这样的语法约定：将扩展名 ".c" 附加到文件名上指示其为源代码文件。在 NameComponent 对象中，kind 字段可用于描述对象类型，而不是文件扩展名或其他语法约定。kind 字段值的示例如下：字符串 "c_source"、"object_code"、"executable"、"postscript" 和 ""。kind 字段为空字符串也很常见。

  在名称中，每个 NameComponent 对象（除了最后一个）都表示一个 NamingContext 对象；最后一个 NameComponent 对象表示绑定的对象引用。这类似于路径名，路径名中最后一个名称是文件名，而前面的所有名称都是目录名。

• public final class Binding - 将名称与对象引用或命名上下文关联的对象。Binding 对象具有两个字段：
  1. binding_name - 表示绑定名称的一个或多个 NameComponent 对象所组成的数组
  2. binding_type - BindingType 对象，该对象指示绑定发生在名称和对象引用之间，还是发生在名称和命名上下文之间

  NamingContext 接口具有一些方法，其中有些用来绑定/取消绑定名称与对象引用或命名上下文，有些用来列举绑定，还有些用来解析绑定（给定名称时，resolve 方法返回绑定到它的对象引用）。

• public final class BindingType - 一个对象，指定给定的 Binding 对象是名称与对象引用（即非命名上下文）之间的绑定还是名称与命名上下文之间的绑定。

  BindingType 类由两个方法和四个常量组成。这些常量中有两个是 BindingType 对象，另外两个是 int。

  BindingType 对象可以传递到 Binding 类的构造方法，也可以用作参数或返回值。这些 BindingType 对象是：

  • public static final BindingType nobject - 指示是与对象引用之间的绑定
  • public static final BindingType ncontext - 指示是与命名上下文之间的绑定

  int 常量可以提供给 from_int 方法以创建 BindingType 对象，也可以作为 value 方法的返回值。这些常量是：

  • public static final int _nobject
  • public static final int _ncontext
  如果提供的 from_int 方法带有的参数是 _nobject 或 _ncontext 之外的任何内容，则它将抛出异常 org.omg.CORBA.BAD_PARAM。

  用法如下：

         BindingType btObject = from_int(_nobject);
         BindingType btContext = from_int(_ncontext);
      

  btObject 变量引用 BindingType 对象，该对象初始化后表示一个与对象引用的绑定。btContext 变量引用 BindingType 对象，该对象初始化后表示一个与 NamingContex 对象的绑定。

  value 方法返回 _nobject 或 _ncontext，因此在以下代码行中，变量 bt 将包含 _nobject 或 _ncontext：

         int bt = BindingType.value();
      

Holder 类

以下是为 org.omg.CosNaming 包生成的 holder 类：

• NamingContextHolder
• BindingIteratorHolder
• BindingHolder
• BindingListHolder
• BindingTypeHolder
• NameComponentHolder
• NameHolder

注意，在 org.omg.CORBA 包中，每个基本 Java 类型都有一个 holder 类：IntHolder、ShortHolder、StringHolder，等等。

另请注意，即使不存在 Name 类，也会存在一个 NameHolder 类；类似地，即使不存在 BindingList 类，也会存在一个 BindingListHolder 类。出现这种现象是因为在 OMG IDL 接口中，Name 和 BindingList 都是 typedef。不存在从 IDL typedef 到 Java 结构的映射，但是如果 typedef 用于序列或数组，则会生成 holder 类。与映射到 Java 编程语言一样，Name 是 NameComponent 对象数组，BindingList 是 Binding 对象数组。 所有 holder 类都具有至少两个构造方法和一个字段：

• value 字段 - 用作 OUT 或 INOUT 参数的类型的实例。例如，NamingContextHolder 的 value 字段将是一个 NamingContext 对象。
• 默认构造方法 - 创建新 holder 对象并使用该类型的默认值初始化的构造方法。例如，用默认构造方法创建的新 BindingHolder 对象的 value 字段将被设置为 null，因为此为对象的默认值。其他默认值有用于 boolean 的 false、用于数值和 char 类型的 0 和用于对象引用的 null。
• 实例中的构造方法 - 创建新 holder 对象并使用提供的实例初始化其 value 字段的构造方法

为用户定义类型（Java 类）创建的 holder 类另外还有三种方法，但是应用程序开发人员不直接使用它们。

Helper 类

Helper 类中只有一种供应用程序员使用的方法。narrow 方法。只有从 IDL 接口映射的 Java 接口才具有包含 narrow 方法的 helper 类，因此在 CosNaming 包中，只有类 NamingContextHelper 和 BindingIteratorHelper 才具有 narrow 方法。

• public static NamingContext narrow(org.omg.CORBA.Object obj) - 将给定的 CORBA 对象转换为 NamingContext 对象
• public static BindingIterator narrow(org.omg.CORBA.Object obj) - 将给定的 CORBA 对象转换为 BindingIterator 对象

org.omg.CosNaming.NamingContextPackage 包

为以下异常提供 Helper 和 Holder 类：

• AlreadyBound
• CannotProceed
• InvalidName
• NotEmpty
• NotFound

命名服务兼容性

第三方命名服务用法说明

1. 为 Bootstrap 服务器创建属性文件，并在该文件中给出两个条目。例如，可以将此属性文件称为 /tmp/services，并将以下内容置于其中：NameService, <Stringified IOR of the Root Naming Context>。

   此操作将 NameService 与要使用的 CosNaming 实现的根命名上下文 (Root Naming Context) 相关联。

2. 使用以下命令启动独立的 Bootstrap 服务器：

         
         java -classpath $(CLASSPATH)
         com.sun.corba.ee.internal.CosNaming.BootstrapServer -InitialServicesFile
         "/tmp/services" [-ORBInitialPort port]
         
     

   注意，位于命令末尾的方括号指示指定一个可选的端口号。

这时，如果应用程序调用 org.omg.CORBA.ORB.resolve_initial_references 方法，则 CORBA 进程将联系 Bootstrap 服务器来获取根命名上下文。

包规范

• Interoperable Naming Service (ptc/00-08-07)

相关文档

• Naming Service

有关 Java IDL 概述，请参阅：

• Java IDL 主页

从以下版本开始：

JDK1.3

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