JavaTM 2 Platform
Standard Ed. 5.0

接口 javax.naming.Name
的使用

使用 Name 的软件包
javax.naming 为访问命名服务提供类和接口。 
javax.naming.directory 扩展 javax.naming 包以提供访问目录服务的功能。 
javax.naming.event 在访问命名和目录服务时提供对事件通知的支持。 
javax.naming.ldap 提供对 LDAPv3 扩展操作和控件的支持。 
javax.naming.spi 提供一些方法来动态地插入对通过 javax.naming 和相关包访问命名和目录服务的支持。 
 

javax.namingName 的使用
 

实现 Namejavax.naming 中的类
 class CompositeName
          此类表示一个复合名称,即一个跨多个名称空间组件名称的序列。
 class CompoundName
          此类表示一个组合名称,即一个取自层次名称空间的名称。
 

声明为 Namejavax.naming 中的字段
protected  Name CannotProceedException.altName
          包含已解析对象的名称,该名称相对于上下文 altNameCtx
protected  Name LinkException.linkRemainingName
          包含尚未解析的剩余链接名称。
protected  Name LinkException.linkResolvedName
          包含已成功解析的链接部分。
protected  Name NamingException.remainingName
          包含尚未解析的剩余名称。
protected  Name CannotProceedException.remainingNewName
          包含 Context.rename() 第二个 "name" 参数的剩余未解析部分。
protected  Name NamingException.resolvedName
          包含已成功解析的名称部分。
 

返回 Namejavax.naming 中的方法
 Name Name.add(int posn, String comp)
          在此名称中的指定位置添加单个组件。
 Name CompoundName.add(int posn, String comp)
          在此组合名称中的指定位置添加单个组件。
 Name CompositeName.add(int posn, String comp)
          在此复合名称中的指定位置添加单个组件。
 Name Name.add(String comp)
          将单个组件添加到此名称的末尾。
 Name CompoundName.add(String comp)
          将单个组件添加到此组合名称的末尾。
 Name CompositeName.add(String comp)
          将单个组件添加到此复合名称的末尾。
 Name Name.addAll(int posn, Name n)
          按顺序将名称的组件添加到此名称中的指定位置。
 Name CompoundName.addAll(int posn, Name n)
          按顺序将组合名称的组件添加到此组合名称中的指定位置。
 Name CompositeName.addAll(int posn, Name n)
          按顺序将复合名称的组件添加到此复合名称中的指定位置。
 Name Name.addAll(Name suffix)
          按顺序将名称的组件添加到此名称的末尾。
 Name CompoundName.addAll(Name suffix)
          按顺序将组合名称的组件添加到此组合名称的末尾。
 Name CompositeName.addAll(Name suffix)
          按顺序将复合名称的组件添加到此复合名称的末尾。
 Name Context.composeName(Name name, Name prefix)
          将此上下文的名称与相对于此上下文的名称组合。
 Name InitialContext.composeName(Name name, Name prefix)
          将此上下文的名称与相对于此上下文的名称组合。
 Name CannotProceedException.getAltName()
          检索此异常的 altName 字段。
 Name LinkException.getLinkRemainingName()
          检索链接名称的剩余未解析部分。
 Name LinkException.getLinkResolvedName()
          检索成功被解析的链接名称的开头部分。
 Name Name.getPrefix(int posn)
          创建一个名称,其组件由此名称中组件的前缀组成。
 Name CompoundName.getPrefix(int posn)
          创建一个组合名称,其组件由此组合名称中组件的前缀组成。
 Name CompositeName.getPrefix(int posn)
          创建一个复合名称,其组件由此复合名称中组件的前缀组成。
 Name NamingException.getRemainingName()
          检索名称的剩余未解析部分。
 Name CannotProceedException.getRemainingNewName()
          检索此异常的 "remaining new name" 字段,当执行 rename() 操作期间抛出此异常时,将使用该字段。
 Name NamingException.getResolvedName()
          检索成功被解析的名称的开头部分。
 Name Name.getSuffix(int posn)
          创建一个名称,其组件由此名称中组件的后缀组成。
 Name CompoundName.getSuffix(int posn)
          创建一个组合名称,其组件由该组合名称中组件的后缀组成。
 Name CompositeName.getSuffix(int posn)
          创建一个复合名称,其组件由此复合名称中组件的后缀组成。
 Name NameParser.parse(String name)
          将某一名称解析成其组件。
 

参数类型为 Namejavax.naming 中的方法
 Name Name.addAll(int posn, Name n)
          按顺序将名称的组件添加到此名称中的指定位置。
 Name CompoundName.addAll(int posn, Name n)
          按顺序将组合名称的组件添加到此组合名称中的指定位置。
 Name CompositeName.addAll(int posn, Name n)
          按顺序将复合名称的组件添加到此复合名称中的指定位置。
 Name Name.addAll(Name suffix)
          按顺序将名称的组件添加到此名称的末尾。
 Name CompoundName.addAll(Name suffix)
          按顺序将组合名称的组件添加到此组合名称的末尾。
 Name CompositeName.addAll(Name suffix)
          按顺序将复合名称的组件添加到此复合名称的末尾。
 void NamingException.appendRemainingName(Name name)
          将 'name' 中的组件作为剩余名称中最后的组件添加。
 void Context.bind(Name name, Object obj)
          将名称绑定到对象。
 void InitialContext.bind(Name name, Object obj)
           
 Name Context.composeName(Name name, Name prefix)
          将此上下文的名称与相对于此上下文的名称组合。
 Name InitialContext.composeName(Name name, Name prefix)
          将此上下文的名称与相对于此上下文的名称组合。
 Context Context.createSubcontext(Name name)
          创建并绑定一个新上下文。
 Context InitialContext.createSubcontext(Name name)
           
 void Context.destroySubcontext(Name name)
          销毁指定上下文,并将它从名称空间中移除。
 void InitialContext.destroySubcontext(Name name)
           
 boolean Name.endsWith(Name n)
          确定此名称是否以某一指定后缀结束。
 boolean CompoundName.endsWith(Name n)
          确定某一组合名称是否是此组合名称的后缀。
 boolean CompositeName.endsWith(Name n)
          确定某一复合名称是否是此复合名称的后缀。
 NameParser Context.getNameParser(Name name)
          检索与指定上下文关联的解析器。
 NameParser InitialContext.getNameParser(Name name)
           
protected  Context InitialContext.getURLOrDefaultInitCtx(Name name)
          检索用来解析 name 的上下文。
 NamingEnumeration<NameClassPair> Context.list(Name name)
          枚举绑定在指定上下文中的名称,以及绑定到这些名称的对象的类名称。
 NamingEnumeration<NameClassPair> InitialContext.list(Name name)
           
 NamingEnumeration<Binding> Context.listBindings(Name name)
          枚举绑定在指定上下文中的名称,以及绑定到这些名称的对象。
 NamingEnumeration<Binding> InitialContext.listBindings(Name name)
           
 Object Context.lookup(Name name)
          检索指定的对象。
 Object InitialContext.lookup(Name name)
           
 Object Context.lookupLink(Name name)
          按照除名称的最终原子组件以外的链接检索指定对象。
 Object InitialContext.lookupLink(Name name)
           
 void Context.rebind(Name name, Object obj)
          将名称绑定到对象,重写任何现有绑定。
 void InitialContext.rebind(Name name, Object obj)
           
 void Context.rename(Name oldName, Name newName)
          将一个新名称绑定到已经被绑定到某一旧名称的对象上,并取消对旧名称的绑定。
 void InitialContext.rename(Name oldName, Name newName)
           
 void CannotProceedException.setAltName(Name altName)
          设置此异常的 altName 字段。
 void LinkException.setLinkRemainingName(Name name)
          设置此异常的剩余链接名称字段。
 void LinkException.setLinkResolvedName(Name name)
          设置此异常的已解析链接名称字段。
 void NamingException.setRemainingName(Name name)
          设置此异常的剩余名称字段。
 void CannotProceedException.setRemainingNewName(Name newName)
          设置此异常的 "remaining new name" 字段。
 void NamingException.setResolvedName(Name name)
          设置此异常的已解析名称字段。
 boolean Name.startsWith(Name n)
          确定此名称是否从某一指定前缀开始。
 boolean CompoundName.startsWith(Name n)
          确定某一组合名称是否是此组合名称的前缀。
 boolean CompositeName.startsWith(Name n)
          确定某一复合名称是否是此复合名称的前缀。
 void Context.unbind(Name name)
          取消对指定对象的绑定。
 void InitialContext.unbind(Name name)
           
 

参数类型为 Namejavax.naming 中的构造方法
LinkRef(Name linkName)
          为某一名称构造一个 LinkRef。
 

javax.naming.directoryName 的使用
 

参数类型为 Namejavax.naming.directory 中的方法
 void InitialDirContext.bind(Name name, Object obj, Attributes attrs)
           
 void DirContext.bind(Name name, Object obj, Attributes attrs)
          将名称与关联的属性一起绑定到一个对象。
 DirContext InitialDirContext.createSubcontext(Name name, Attributes attrs)
           
 DirContext DirContext.createSubcontext(Name name, Attributes attrs)
          创建并绑定新的上下文及关联的属性。
 Attributes InitialDirContext.getAttributes(Name name)
           
 Attributes DirContext.getAttributes(Name name)
          检索与命名对象关联的所有属性。
 Attributes InitialDirContext.getAttributes(Name name, String[] attrIds)
           
 Attributes DirContext.getAttributes(Name name, String[] attrIds)
          检索与命名对象关联的选定属性。
 DirContext InitialDirContext.getSchema(Name name)
           
 DirContext DirContext.getSchema(Name name)
          检索与命名对象关联的模式。
 DirContext InitialDirContext.getSchemaClassDefinition(Name name)
           
 DirContext DirContext.getSchemaClassDefinition(Name name)
          检索包含命名对象类定义的模式对象的上下文。
 void InitialDirContext.modifyAttributes(Name name, int mod_op, Attributes attrs)
           
 void DirContext.modifyAttributes(Name name, int mod_op, Attributes attrs)
          修改与命名对象关联的属性。
 void InitialDirContext.modifyAttributes(Name name, ModificationItem[] mods)
           
 void DirContext.modifyAttributes(Name name, ModificationItem[] mods)
          使用有序的修改列表修改与命名对象关联的属性。
 void InitialDirContext.rebind(Name name, Object obj, Attributes attrs)
           
 void DirContext.rebind(Name name, Object obj, Attributes attrs)
          将名称与关联的属性一起绑定到一个对象,并重写任何现有绑定。
 NamingEnumeration<SearchResult> InitialDirContext.search(Name name, Attributes matchingAttributes)
           
 NamingEnumeration<SearchResult> DirContext.search(Name name, Attributes matchingAttributes)
          在单个上下文中搜索包含指定属性集的对象。
 NamingEnumeration<SearchResult> InitialDirContext.search(Name name, Attributes matchingAttributes, String[] attributesToReturn)
           
 NamingEnumeration<SearchResult> DirContext.search(Name name, Attributes matchingAttributes, String[] attributesToReturn)
          在单个上下文中搜索包含指定属性集的对象,并检索选定的属性。
 NamingEnumeration<SearchResult> InitialDirContext.search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)
           
 NamingEnumeration<SearchResult> DirContext.search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)
          在命名上下文或对象中搜索符合给定搜索过滤器的项。
 NamingEnumeration<SearchResult> InitialDirContext.search(Name name, String filter, SearchControls cons)
           
 NamingEnumeration<SearchResult> DirContext.search(Name name, String filter, SearchControls cons)
          在命名上下文或对象中搜索符合给定搜索过滤器的项。
 

javax.naming.eventName 的使用
 

参数类型为 Namejavax.naming.event 中的方法
 void EventContext.addNamingListener(Name target, int scope, NamingListener l)
          添加接收命名事件的侦听器,这些事件在目标和范围所标识的对象发生更改时触发。
 void EventDirContext.addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)
          添加接收命名事件的侦听器,这些事件在修改由 target 指定的对象上的搜索过滤器 filter 和过滤器参数标识的对象时触发。
 void EventDirContext.addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l)
          添加接收命名事件的侦听器,这些事件在修改由 target 指定的对象上的搜索过滤器 filter 标识的对象时触发。
 

javax.naming.ldapName 的使用
 

实现 Namejavax.naming.ldap 中的类
 class LdapName
          此类表示 RFC 2253 指定的标识名。
 

返回 Namejavax.naming.ldap 中的方法
 Name LdapName.add(int posn, Rdn comp)
          将单个 RDN 添加到此 LDAP 名称中的指定位置。
 Name LdapName.add(int posn, String comp)
          将单个组件添加到此 LDAP 名称中的指定位置。
 Name LdapName.add(Rdn comp)
          将单个 RDN 添加到此 LDAP 名称的末尾。
 Name LdapName.add(String comp)
          将单个组件添加到此 LDAP 名称的末尾。
 Name LdapName.addAll(int posn, List<Rdn> suffixRdns)
          按顺序将名称的 RDN 添加到此名称中的指定位置。
 Name LdapName.addAll(int posn, Name suffix)
          按顺序将名称的组件添加到此名称中的指定位置。
 Name LdapName.addAll(List<Rdn> suffixRdns)
          按顺序将名称的 RDN 添加到此名称的末尾。
 Name LdapName.addAll(Name suffix)
          按顺序将名称的组件添加到此名称的末尾。
 Name LdapName.getPrefix(int posn)
          创建一个名称,其组件由此 LDAP 名称中组件的前缀组成。
 Name LdapName.getSuffix(int posn)
          创建一个名称,其组件由此 LDAP 名称中组件的后缀组成。
 

参数类型为 Namejavax.naming.ldap 中的方法
 Name LdapName.addAll(int posn, Name suffix)
          按顺序将名称的组件添加到此名称中的指定位置。
 Name LdapName.addAll(Name suffix)
          按顺序将名称的组件添加到此名称的末尾。
 boolean LdapName.endsWith(Name n)
          确定此 LDAP 名称是否以某一指定 LDAP 名称后缀结尾。
 boolean LdapName.startsWith(Name n)
          确定此 LDAP 名称是否从某一指定 LDAP 名称前缀开始。
 

javax.naming.spiName 的使用
 

声明为 Namejavax.naming.spi 中的字段
protected  Name ResolveResult.remainingName
          该字段包含要解析的剩余名称。
 

返回 Namejavax.naming.spi 中的方法
 Name ResolveResult.getRemainingName()
          检索名称的剩余未解析部分。
 

参数类型为 Namejavax.naming.spi 中的方法
 void ResolveResult.appendRemainingName(Name name)
          将组件添加到剩余名称的末尾。
 Object ObjectFactory.getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)
          使用指定的位置或引用信息创建一个对象。
static Object NamingManager.getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment)
          为指定对象和环境创建一个对象实例。
static Object DirectoryManager.getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs)
          为指定对象、属性和环境创建一个对象实例。
 Object DirObjectFactory.getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs)
          使用位置或引用信息以及指定的属性创建一个对象。
 Object StateFactory.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)
          检索用于绑定的对象状态。
static Object NamingManager.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)
          检索用于绑定的对象的状态。
static DirStateFactory.Result DirectoryManager.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes attrs)
          在给定初始对象及其属性时,检索用于绑定的对象的状态。
 DirStateFactory.Result DirStateFactory.getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment, Attributes inAttrs)
          在给定要传输的对象和属性的情况下检索用于绑定的对象的状态。
 ResolveResult Resolver.resolveToClass(Name name, Class<? extends Context> contextType)
          部分解析某一名称。
 void ResolveResult.setRemainingName(Name name)
          将此结果的剩余名称字段设置为 name。
 

参数类型为 Namejavax.naming.spi 中的构造方法
ResolveResult(Object robj, Name rname)
          构造一个新的 ResolveResult 实例,该实例由已解析 Object 和剩余名称组成。
 


JavaTM 2 Platform
Standard Ed. 5.0

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

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