Package org.omg.CosNaming

对于java IDL提供命名服务。

See: 描述

接口摘要

接口	描述
BindingIterator	的bindingiterator接口允许客户端遍历绑定使用next_one或next_n操作。
BindingIteratorOperations	的bindingiterator接口允许客户端遍历绑定使用next_one或next_n操作。
NamingContext	一个命名上下文是一个对象，它包含一组名称绑定，其中每个名称都是唯一的。
NamingContextExt	NamingContextExt是 NamingContext包含一组名字的绑定中的每个名字都是独特的，是可互操作的命名服务部分的延伸。
NamingContextExtOperations	NamingContextExt是 NamingContext包含一组名字的绑定中的每个名字都是独特的，是可互操作的命名服务部分的延伸。
NamingContextOperations	一个命名上下文是一个对象，它包含一组名称绑定，其中每个名称都是唯一的。

类摘要

类	描述
_BindingIteratorImplBase
_BindingIteratorStub	的bindingiterator接口允许客户端遍历绑定使用next_one或next_n操作。
_NamingContextExtStub	NamingContextExt是 NamingContext包含一组名字的绑定中的每个名字都是独特的，是可互操作的命名服务部分的延伸。
_NamingContextImplBase
_NamingContextStub	一个命名上下文是一个对象，它包含一组名称绑定，其中每个名称都是唯一的。
Binding	org /天/形式/ binding.java。
BindingHelper	org /天/形式/ bindinghelper.java。
BindingHolder	org /天/形式/ bindingholder.java。
BindingIteratorHelper	的bindingiterator接口允许客户端遍历绑定使用next_one或next_n操作。
BindingIteratorHolder	的bindingiterator接口允许客户端遍历绑定使用next_one或next_n操作。
BindingIteratorPOA	的bindingiterator接口允许客户端遍历绑定使用next_one或next_n操作。
BindingListHelper	绑定列表。
BindingListHolder	绑定列表。
BindingType	指定给定的绑定是否为对象（不是一个命名上下文）或一个命名上下文。
BindingTypeHelper	指定给定的绑定是否为对象（不是一个命名上下文）或一个命名上下文。
BindingTypeHolder	指定给定的绑定是否为对象（不是一个命名上下文）或一个命名上下文。
IstringHelper	org /天/形式/ istringhelper.java。
NameComponent	org /天/形式/ NameComponent.java。
NameComponentHelper	org /天/形式/ NameComponentHelper.java。
NameComponentHolder	org /天/形式/ NameComponentHolder.java。
NameHelper	一个名称是一个名称组件的序列。
NameHolder	一个名称是一个名称组件的序列。
NamingContextExtHelper	NamingContextExt是 NamingContext包含一组名字的绑定中的每个名字都是独特的，是可互操作的命名服务部分的延伸。
NamingContextExtHolder	NamingContextExt是 NamingContext包含一组名字的绑定中的每个名字都是独特的，是可互操作的命名服务部分的延伸。
NamingContextExtPOA	NamingContextExt是 NamingContext包含一组名字的绑定中的每个名字都是独特的，是可互操作的命名服务部分的延伸。
NamingContextHelper	一个命名上下文是一个对象，它包含一组名称绑定，其中每个名称都是唯一的。
NamingContextHolder	一个命名上下文是一个对象，它包含一组名称绑定，其中每个名称都是唯一的。
NamingContextPOA	一个命名上下文是一个对象，它包含一组名称绑定，其中每个名称都是唯一的。

Package org.omg.CosNaming Description

对于java IDL提供命名服务。对象请求代理守护进程（orbd）还包括一个短暂的和持久的命名服务。

包和所有它的类和接口是由运行在文件nameservice.idl工具idlj产生，这是一个模块用OMG IDL。

包装规格

对于精确的列出与该java [商标]平台官方支持的部分规格，标准版6，宝珠答应，看到Official Specifications for CORBA support in Java[tm] SE 6。

接口

包 org.omg.CosNaming包含两个公共接口和一些辅助类。

接口是：

• NamingContext
• BindingIterator

这两个接口提供的方法绑定/解除绑定名称和对象引用，检索绑定的对象的引用，并遍历列表的绑定。NamingContext接口的命名服务提供的主要功能，并提供了BindingIterator遍历列表名称/对象引用绑定的方法。

辅助类

为了图个OMG IDL接口的java编程语言，创建java类idlj编译器可以作为辅助类。对生成的辅助类的接口 NamingContext和 BindingIterator用注释包含在这里。

通过NamingContext和BindingIterator用类

以下是用于命名服务的类。（助手和人类，这是一列在这里，生成类下文。）

• public final class NameComponent --名称砌块。（名称绑定到一个命名上下文。参考对象）

  一个名字是一个或多个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对象是一个名字和一个对象引用之间的结合（即不是一个命名上下文）之间或一个名字和一个命名上下文。

  的classBindingType由两个方法和四个常数。这两个常数BindingType对象，并且两ints。

  的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，下面的一行代码，变量将包含_nobject或_ncontext bt：

  国际bindingtype value() BT =；

架类

OMG IDL使用out和inout从操作的返回值参数。映射到java编程语言，没有out和inout参数，为每个类型中特殊的一类，称为容器类。一架类的一个实例可以作为一个参数传递给一个java方法，和一个值可以分配给它的 value场。这允许它执行功能的一种或者INOUT参数。

下面的人类的封装org.omg.CosNaming生成：

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

值得注意的是org.omg.CORBA包，都有一个基本的java类型的容器类：IntHolder，ShortHolder，StringHolder，等等。

注意，有一个NameHolder课虽然没有Name类；同样，有一个BindingListHolder课虽然没有BindingList类。这是因为在OMG IDL接口，Name和BindingList是typedefs。没有从IDL typedef映射到java类的构造，但人如果typedef是一个序列或数组生成。作为映射到java编程语言，Name是NameComponent对象的数组，和BindingList是Binding对象数组。所有保持器类都有至少两个构造函数和一个字段：

• value场--一个实例的类型作为或INOUT参数。例如，一个NamingContextHolder的value领域将是一个NamingContext对象。
• 默认构造函数-一个构造函数，创建一个新的持有人的对象初始化为默认值的类型。例如，一个新的BindingHolder对象创建的默认构造函数将其value字段设置为null因为是对象的默认值。其他的默认值为boolean false，0数字和字符类型和对象引用null。
• 从一个实例构造函数，构造函数，创建一个新对象的value场持有人与实例提供的初始化

一个用户定义类型的容器类（java类）有三个以上的方法，但应用程序开发人员不直接使用它们。

辅助类

助手类，它是所有用户定义的类型在OMG IDL接口生成，供给静态方法需要操纵这些类型。

这是一个辅助类，应用程序只使用一个方法：该方法narrow。只有java接口映射到IDL接口将有一个辅助类，包括narrow方法，所以在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

这个包提供帮手和人类的异常包中使用 org.omg.CosNaming也为班级 NotFoundReason，为例外 NotFound理由。

有以下异常的辅助器和保持类：

• AlreadyBound
• CannotProceed
• InvalidName
• NotEmpty
• NotFound

命名服务的兼容性

太阳实现的 CosNaming包装符合OMG COSNaming规范。换句话说，在太阳的命名服务的API是根据命名服务提供的准则实施OMG。因此，如果一个第三方供应商实施了命名服务是OMG的标准，它是可能的开关之间的 CosNaming太阳的实施和第三方厂商的实现。然而，重要的是要了解在不同的供应商实现命名服务的方式上有微小的变化，如异常字符串的差异。

使用三分之一方命名服务的说明

虽然我们鼓励使用一个球体，球体的服务，都是从一个供应商，它可以插入三分之一方的 COSNaming实现太阳RMI-IIOP宝珠。下面是步骤：

1. 为引导服务器创建一个属性文件，并给它两个条目。例如，你可以调用这个属性文件/tmp/services，把下面的：NameService, <Stringified IOR of the Root Naming Context>。

   本公司NameService与根命名上下文的CosNaming实现您想要使用。

2. 使用下面的命令启动独立引导服务器：

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

   请注意，命令结束时的方括号表示指定端口号是可选的。

现在，当应用程序调用的方法org.omg.CORBA.ORB.resolve_initial_references，CORBA的过程将与引导服务器获得根命名上下文。

包装规格

• 可互操作的命名服务（ptc/00-08-07）

相关文件

概述和如何使用 CosNaming API，请看：

• Naming Service

对于java IDL的概述，请参阅：

• Java IDL home page

从以下版本开始：

JDK1.3