Java javax.naming 类 Reference（JDK5）

所有类

javax.naming
类 Reference

java.lang.Object
  javax.naming.Reference

所有已实现的接口：

Serializable, Cloneable

直接已知子类：

LinkRef

public class Reference
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Cloneable, Serializable
   
   
   
   
   

此类表示对存在于命名/目录系统以外的对象的引用。

Reference 提供一种记录关于没有直接绑定到命名/目录系统的对象的地址信息的方式。

Reference 由有序地址列表和有关将被引用的对象的类信息组成。列表中的每个地址都标识一个用于相同概念上的对象的通信端点。“通信端点”是指示如何与对象进行联系的信息。例如，它可以是一个网络地址、本地机器内存中的一个位置、同一台机器上的另一个进程等等。列表中地址的顺序对于解释引用的对象工厂而言可能很重要。

出现多个地址的原因有很多，比如重复或者对象在多于一种的通信机制上提供接口。该地址的索引从零开始。

Reference 还包含信息，该信息有助于创建此 Reference 所引用的对象的实例。它包含该对象的类名称，以及用来创建该对象的工厂的类名称和位置。类工厂位置是以空格分隔的 URL 列表，这些 URL 表示用来加载该工厂的类路径。当需要加载工厂类（或任何它所依赖的类或资源）时，将（依次）使用每个 URL 来尝试加载该类。

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

从以下版本开始：

1.3

另请参见：

RefAddr, StringRefAddr, BinaryRefAddr, 序列化表格

className

protected String className

包含此 Reference 所引用的对象类的完全限定名称。

另请参见：

Class.getName()

addrs

protected Vector<RefAddr> addrs

包含此 Reference 中所包含的地址。由构造方法初始化。

classFactory

protected String classFactory

包含用来创建此 Reference 所引用的对象实例的工厂类名称。被初始化为 null。

classFactoryLocation

protected String classFactoryLocation

包含工厂类的位置。被初始化为 null。

Reference

public Reference(String className)

使用类名称 'className' 构造对某个对象的新引用。类工厂和类工厂位置都被设置为 null。新创建的引用不包含任何地址。

参数：

className - 此引用所引用对象的非 null 类名称。

Reference

public Reference(String className,
                 RefAddr addr)

使用类名称 'className' 和一个地址构造对某个对象的新引用。类工厂和类工厂位置都被设置为 null。

参数：

className - 此引用所引用对象的非 null 类名称。

addr - 对象的非 null 地址。

Reference

public Reference(String className,
                 String factory,
                 String factoryLocation)

使用类名称 'className' 以及对象工厂的类名称和位置创建对某个对象的新引用。

参数：

className - 此引用所引用对象的非 null 类名称。

factory - 对象工厂的类名称（可能为 null）。

factoryLocation - 加载工厂的、可能为 null 的位置（例如 URL）

另请参见：

ObjectFactory, NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)

Reference

public Reference(String className,
                 RefAddr addr,
                 String factory,
                 String factoryLocation)

使用类名称 'className'、对象工厂的类名称和位置以及对象的地址创建该对某个对象的新引用。

参数：

className - 此引用所引用对象的非 null 类名称。

factory - 对象工厂的类名称（可能为 null）。

factoryLocation - 加载工厂的、可能为 null 的位置（例如 URL）

addr - 对象的非 null 地址。

另请参见：

ObjectFactory, NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)

getClassName

public String getClassName()

检索此引用所引用对象的类名称。

返回：

该对象的非 null 完全限定类名称。（例如 "java.lang.String"）