JavaTM Platform
Standard Ed. 6

javax.naming
类 NameClassPair

java.lang.Object
  继承者 javax.naming.NameClassPair
所有已实现的接口:
Serializable
直接已知子类:
Binding

public class NameClassPair
     
extends Object
implements Serializable

此类表示存在于上下文中的某一绑定的对象名称和类名称对。

上下文由名称到对象的绑定组成。NameClassPair 类表示所绑定对象的名称和类。它由一个名称和表示包限定类名称的字符串组成。

对于动态生成名称/类对内容的命名系统,要创建子类。

NameClassPair 实例与多个线程的并发访问不同步。需要并发地访问 NameClassPair 的线程应该在它们之间实现同步并提供所需的锁定。

从以下版本开始:
1.3
另请参见:
Context.list(javax.naming.Name), 序列化表格

构造方法摘要
NameClassPair(String name, String className)
          在给定名称和类名称的情况下构造一个 NameClassPair 实例。
NameClassPair(String name, String className, boolean isRelative)
          在给定其名称、类名称以及该名称是否相对于列表上下文的情况下构造一个 NameClassPair 实例。
 
方法摘要
 String getClassName()
          检索绑定到此绑定名称的对象的类名称。
 String getName()
          检索此绑定的名称。
 String getNameInNamespace()
          检索此绑定的完全名称。
 boolean isRelative()
          确定此绑定的名称是否相对于目标上下文(由 list() 方法的第一个参数命名)。
 void setClassName(String name)
          设置此绑定的类名称。
 void setName(String name)
          设置此绑定的名称。
 void setNameInNamespace(String fullName)
          设置此绑定的完全名称。
 void setRelative(boolean r)
          设置此绑定的名称是否相对于目标上下文(由 list() 方法的第一个参数命名)。
 String toString()
          生成此名称/类对的字符串表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

NameClassPair

public NameClassPair(String name,
                     String className)
在给定名称和类名称的情况下构造一个 NameClassPair 实例。

参数:
name - 对象的非 null 名称。它是相对于 目标上下文(由 list() 方法的第一个参数指定)的名称
className - 绑定到 name 的对象的类名称(可能为 null)。如果所绑定的对象为 null,则该参数为 null。
另请参见:
getClassName(), setClassName(java.lang.String), getName(), setName(java.lang.String)

NameClassPair

public NameClassPair(String name,
                     String className,
                     boolean isRelative)
在给定其名称、类名称以及该名称是否相对于列表上下文的情况下构造一个 NameClassPair 实例。

参数:
name - 对象的非 null 名称。
className - 绑定到 name 的对象的类名称(可能为 null)。如果所绑定的对象为 null,则该参数为 null。
isRelative - 如果 name 是一个相对于目标上下文(由 list() 方法的第一个参数命名)的名称,则该参数为 true;如果 name 是一个 URL 字符串,则该参数为 false。
另请参见:
getClassName(), setClassName(java.lang.String), getName(), setName(java.lang.String), isRelative(), setRelative(boolean)
方法详细信息

getClassName

public String getClassName()
检索绑定到此绑定名称的对象的类名称。如果绑定了某一引用或其他一些间接信息,则检索将由 Binding.getObject() 返回的最终对象的类名称。

返回:
所绑定对象的可能为 null 的类名称。如果所绑定的对象为 null,则该参数为 null。
另请参见:
Binding.getObject(), Binding.getClassName(), setClassName(java.lang.String)

getName

public String getName()
检索此绑定的名称。如果 isRelative() 为 true,则此名称相对于目标上下文(由 list() 的第一个参数命名)。如果 isRelative() 为 false,则此名称是一个 URL 字符串。

返回:
此绑定的非 null 名称。
另请参见:
isRelative(), setName(java.lang.String)

setName

public void setName(String name)
设置此绑定的名称。

参数:
name - 将用作该名称的非 null 字符串。
另请参见:
getName(), setRelative(boolean)

setClassName

public void setClassName(String name)
设置此绑定的类名称。

参数:
name - 将用作类名称的可能为 null 的字符串。如果为 null,则 Binding.getClassName() 将返回该绑定中对象的实际类名称。如果所绑定对象为 null,则类名称也将为 null。
另请参见:
getClassName(), Binding.getClassName()

isRelative

public boolean isRelative()
确定此绑定的名称是否相对于目标上下文(由 list() 方法的第一个参数命名)。

返回:
如果此绑定的名称相对于目标上下文,则返回 true;如果此绑定的名称是一个 URL 字符串,则返回 false。
另请参见:
setRelative(boolean), getName()

setRelative

public void setRelative(boolean r)
设置此绑定的名称是否相对于目标上下文(由 list() 方法的第一个参数命名)。

参数:
r - 如果为 true,则绑定的名称相对于目标上下文;如果为 false,则绑定的名称是一个 URL 字符串。
另请参见:
isRelative(), setName(java.lang.String)

getNameInNamespace

public String getNameInNamespace()
检索此绑定的完全名称。该完全名称是此绑定在其自己的名称空间中的绝对名称。请参见 Context.getNameInNamespace()

在没有将完全名称的概念应用于此绑定的命名系统中,将抛出 UnsupportedOperationException。使用引入该方法之前编写的服务提供者时也会抛出此异常。

此方法返回的字符串不是一个 JNDI 复合名称,不应将它直接传递给上下文方法。

返回:
此绑定的完全名称。
抛出:
UnsupportedOperationException - 如果完全名称的概念没有应用于命名系统中的此绑定。
从以下版本开始:
1.5
另请参见:
setNameInNamespace(java.lang.String), getName()

setNameInNamespace

public void setNameInNamespace(String fullName)
设置此绑定的完全名称。只要创建 NameClassPair 并且一个完全名称可应用于此绑定,就必须调用此方法设置完全名称。

将完全名称设置为 null(或者根本不设置它)将导致 getNameInNamespace() 抛出异常。

参数:
fullName - 要使用的完全名称。
从以下版本开始:
1.5
另请参见:
getNameInNamespace(), setName(java.lang.String)

toString

public String toString()
生成此名称/类对的字符串表示形式。该字符串表示形式由以冒号 (':') 分隔的名称和类名称组成。此字符串的内容用于调试目的,不以编程方式对其进行解释。

覆盖:
Object 中的 toString
返回:
此名称/类对的字符串表示形式。

JavaTM Platform
Standard Ed. 6

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

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