JavaTM Platform
Standard Ed. 6

javax.naming
类 Binding

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

public class Binding
extends NameClassPair

此类表示上下文中一个名称到对象的绑定。

上下文由名称到对象的绑定组成。Binding 类表示的就是这种绑定。它由一个名称和一个对象组成。Context.listBindings() 方法返回一个 Binding 枚举。

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

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

从以下版本开始:
1.3
另请参见:
序列化表格

构造方法摘要
Binding(String name, Object obj)
          在给定其名称和对象的情况下构造一个 Binding 实例。
Binding(String name, Object obj, boolean isRelative)
          在给定其名称、对象以及该名称是否是相对名称的情况下构造一个 Binding 实例。
Binding(String name, String className, Object obj)
          在给定其名称、类名称和对象的情况下构造一个 Binding 实例。
Binding(String name, String className, Object obj, boolean isRelative)
          在给定其名称、类名称、对象以及该名称是否是相对名称的情况下构造一个 Binding 实例。
 
方法摘要
 String getClassName()
          检索绑定到此绑定名称的对象的类名称。
 Object getObject()
          检索绑定到此绑定名称的对象。
 void setObject(Object obj)
          设置与此绑定关联的对象。
 String toString()
          生成此绑定的字符串表示形式。
 
从类 javax.naming.NameClassPair 继承的方法
getName, getNameInNamespace, isRelative, setClassName, setName, setNameInNamespace, setRelative
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

Binding

public Binding(String name,
               Object obj)
在给定其名称和对象的情况下构造一个 Binding 实例。

如果还没有使用 setClassName() 显式设置类名称,则 getClassName() 将返回 obj 的类名称(或者 null,如果 obj 为 null)。

参数:
name - 对象的非 null 名称。它是相对于目标上下文(由 listBindings() 方法的第一个参数指定)的名称
obj - 绑定到 name 的可能为 null 的对象。
另请参见:
NameClassPair.setClassName(java.lang.String)

Binding

public Binding(String name,
               Object obj,
               boolean isRelative)
在给定其名称、对象以及该名称是否是相对名称的情况下构造一个 Binding 实例。

如果还没有使用 setClassName() 显式设置类名称,则 getClassName() 将返回 obj 的类名称(或者 null,如果 obj 为 null)。

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

Binding

public Binding(String name,
               String className,
               Object obj)
在给定其名称、类名称和对象的情况下构造一个 Binding 实例。

参数:
name - 对象的非 null 名称。它是相对于目标上下文(由 listBindings() 方法的第一个参数命名)的名称
className - 绑定到 name 的对象的类名称(可能为 null)。如果为 null,则 obj 的类名称由 getClassName() 返回。如果 obj 也为 null,则 getClassName() 将返回 null。
obj - 绑定到 name 的可能为 null 的对象。
另请参见:
NameClassPair.setClassName(java.lang.String)

Binding

public Binding(String name,
               String className,
               Object obj,
               boolean isRelative)
在给定其名称、类名称、对象以及该名称是否是相对名称的情况下构造一个 Binding 实例。

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

getClassName

public String getClassName()
检索绑定到此绑定名称的对象的类名称。如果已经显式设置该类名称,则返回该名称。如果未显式设置该类名称,且此绑定包含非 null 对象,则使用该对象的类名称。如果未显式设置该类名称,且此绑定不包含非 null 对象,返回 null。

覆盖:
NameClassPair 中的 getClassName
返回:
包含所绑定对象的类名称的字符串(可能为 null)。
另请参见:
getObject(), getClassName(), NameClassPair.setClassName(java.lang.String)

getObject

public Object getObject()
检索绑定到此绑定名称的对象。

返回:
绑定的对象;如果此绑定没有包含任何对象,则返回 null。
另请参见:
setObject(java.lang.Object)

setObject

public void setObject(Object obj)
设置与此绑定关联的对象。

参数:
obj - 要使用的可能为 null 的对象。
另请参见:
getObject()

toString

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

覆盖:
NameClassPair 中的 toString
返回:
此绑定的非 null 字符串表示形式。

JavaTM Platform
Standard Ed. 6

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

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