java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

org.omg.CosNaming
接口 NamingContextOperations

所有已知子接口:
NamingContext, NamingContextExt, NamingContextExtOperations
所有已知实现类:
_NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, NamingContextExtPOA, NamingContextPOA

public interface NamingContextOperations

命名上下文是包含一组名称绑定的对象,在这些名称绑定中,每个名称都是唯一的。可以同时将不同名称绑定到相同或不同上下文中的对象。

请参阅 CORBA COS 命名规范


方法摘要
 void bind_context(NameComponent[] n, NamingContext nc)
          命名作为命名上下文的对象。
 NamingContext bind_new_context(NameComponent[] n)
          此操作创建新上下文并将其绑定到作为参数提供的名称。
 void bind(NameComponent[] n, Object obj)
          在命名上下文中创建名称和对象的绑定。
 void destroy()
          destroy 操作删除命名上下文。
 void list(int how_many, BindingListHolder bl, BindingIteratorHolder bi)
          list 操作允许客户端迭代命名上下文中的一组绑定。
 NamingContext new_context()
          此操作返回调用该操作的上下文的命名服务器实现的命名上下文。
 void rebind_context(NameComponent[] n, NamingContext nc)
          在命名上下文中创建名称和命名上下文的绑定,即使该名称已经绑定在上下文中。
 void rebind(NameComponent[] n, Object obj)
          在命名上下文中创建名称和对象的绑定,即使该名称已经绑定在上下文中。
 Object resolve(NameComponent[] n)
          解析操作是指检索绑定到给定上下文中名称的对象的过程。
 void unbind(NameComponent[] n)
          unbind 操作从上下文移除名称绑定。
 

方法详细信息

bind

void bind(NameComponent[] n,
          Object obj)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound
在命名上下文中创建名称和对象的绑定。在传递组合名称以进行解析时,使用 bind 绑定的命名上下文不参与名称解析。

参数:
n - 对象名

obj - 要与给定名称绑定在一起的对象

抛出:
NotFound - 指示名称不标识绑定。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

AlreadyBound - 指示已将对象绑定到指定名称。


bind_context

void bind_context(NameComponent[] n,
                  NamingContext nc)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound
命名作为命名上下文的对象。在传递组合名称以进行解析时,使用 bind_context() 绑定的命名上下文参与名称解析。

参数:
n - 对象名

nc - 要与给定名称绑定在一起的 NamingContect 对象

抛出:
NotFound - 指示名称不标识绑定。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

AlreadyBound - 指示已将对象绑定到指定名称。


rebind

void rebind(NameComponent[] n,
            Object obj)
            throws NotFound,
                   CannotProceed,
                   InvalidName
在命名上下文中创建名称和对象的绑定,即使该名称已经绑定在上下文中。在传递组合名称以进行解析时,使用 rebind 绑定的命名上下文不参与名称解析。

参数:
n - 对象名

抛出:
NotFound - 指示名称不标识绑定。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。


rebind_context

void rebind_context(NameComponent[] n,
                    NamingContext nc)
                    throws NotFound,
                           CannotProceed,
                           InvalidName
在命名上下文中创建名称和命名上下文的绑定,即使该名称已经绑定在上下文中。在传递组合名称以进行解析时,使用 rebind_context() 绑定的命名上下文参与名称解析。

参数:
n - 对象名

nc - 要与给定名称重新绑定在一起的 NamingContect 对象

抛出:
NotFound - 指示名称不标识绑定。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。


resolve

Object resolve(NameComponent[] n)
               throws NotFound,
                      CannotProceed,
                      InvalidName
解析操作是指检索绑定到给定上下文中名称的对象的过程。给定名称必须与绑定名称完全匹配。命名服务不返回对象的类型。客户端负责将对象“收缩”为适当的类型。即客户端通常将返回对象由 Object 强制转换为更专用的接口。

参数:
n - 对象名

抛出:
NotFound - 指示名称不标识绑定。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。


unbind

void unbind(NameComponent[] n)
            throws NotFound,
                   CannotProceed,
                   InvalidName
unbind 操作从上下文移除名称绑定。

参数:
n - 对象名

抛出:
NotFound - 指示名称不标识绑定。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。


list

void list(int how_many,
          BindingListHolder bl,
          BindingIteratorHolder bi)
list 操作允许客户端迭代命名上下文中的一组绑定。

list 操作在 BindingList bl 中返回最多可以达到的请求绑定数。

  • 如果命名上下文包含附加绑定,则 list 操作将返回带有附加绑定的 BindingIterator。
  • 如果命名上下文不包含附加绑定,则绑定迭代器为 nil 对象引用。

参数:
how_many - 要返回的最大绑定数

bl - 返回的绑定列表

bi - 返回的绑定迭代器


new_context

NamingContext new_context()
此操作返回调用该操作的上下文的命名服务器实现的命名上下文。没有将新上下文绑定到任何名称。


bind_new_context

NamingContext bind_new_context(NameComponent[] n)
                               throws NotFound,
                                      AlreadyBound,
                                      CannotProceed,
                                      InvalidName
此操作创建新上下文并将其绑定到作为参数提供的名称。新创建的上下文由将其绑定到的上下文的命名服务器(即实现名称参数(最后一个组件除外)表示的上下文的命名服务器)实现。

参数:
n - 对象名

抛出:
NotFound - 指示名称不标识绑定。

AlreadyBound - 指示已将对象绑定到指定名称。

CannotProceed - 指示由于某种原因放弃了实现。不过,客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。


destroy

void destroy()
             throws NotEmpty
destroy 操作删除命名上下文。如果命名上下文包含绑定,则引发 NotEmpty 异常。

抛出:
NotEmpty - 指示命名上下文包含绑定。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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