Reference (Java Platform SE 8 )

java.lang.Object
- javax.naming.Reference

All Implemented Interfaces:

Serializable， Cloneable

已知直接子类：

LinkRef
```
public class Reference
extends Object
implements Cloneable, Serializable
```
此类表示在命名目录系统之外的一个对象的引用。
参考提供了一种记录有关对象的地址信息的方法，这些信息本身不直接绑定到命名/目录系统。

一个引用包含被引用的对象的地址和类信息的有序列表。列表中的每个地址都标识相同的概念对象的通信端点。“通信端点”是指示如何与对象联系的信息。它可以是，例如，一个网络地址，在本地机器上的内存的位置，在同一台机器上的另一个进程。列表中的地址的顺序可能是对解释参考的对象的重要意义。

多个地址可能会出现各种原因，如复制或对象提供一个以上的通信机制的接口。该地址是索引从零开始。

参考还包含了信息，以帮助创建此引用所引用的对象的实例。它包含该对象的类名称，以及用于创建对象的工厂的类别名称和位置。类工厂位置是用来加载工厂的类路径的一个空格分隔的目录列表。当工厂类（或任何它所依赖的类或资源）需要被加载时，每个网址都使用（为了）尝试加载类。

一个参考实例不同步对多个线程的并发访问。需要访问一个单一的参考的线程同时应同步之间的自己，并提供必要的锁定。

从以下版本开始：

一点三

另请参见：

RefAddr， StringRefAddr， BinaryRefAddr， Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected Vector<RefAddr>`	`addrs` 包含此引用中包含的地址。
`protected String`	`classFactory` 包含用于创建此引用引用的对象的实例的工厂类的名称。
`protected String`	`classFactoryLocation` 包含工厂类的位置。
`protected String`	`className` 包含此引用所引用的对象的类的完全限定名称。

构造方法摘要

构造方法
Constructor and Description
`Reference(String className)` 为建立具有类名称的类名对象的一个新的参考”。
`Reference(String className, RefAddr addr)` 构建与类的名字“类名”和一个地址的对象的一个新的参考。
`Reference(String className, RefAddr addr, String factory, String factoryLocation)` 构建与类的名字“类名”的对象，一个新的参考，班级名称和对象的工厂位置，并对对象的地址。
`Reference(String className, String factory, String factoryLocation)` 构建与类的名字“类名”对象的一个新的参考，和类的名称和对象的工厂位置。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`add(int posn, RefAddr addr)` 添加一个地址到地址列表索引位置。
`void`	`add(RefAddr addr)` 在地址列表的结尾添加一个地址。
`void`	`clear()` 从这个引用中删除所有地址。
`Object`	`clone()` 使用它的地址类名称列表、类工厂名称和类工厂位置的引用的副本。
`boolean`	`equals(Object obj)` 确定目标是一个具有相同地址的引用（在相同的顺序）作为参考。
`RefAddr`	`get(int posn)` 在索引中检索输入的地址。
`RefAddr`	`get(String addrType)` 获取第一个地址，地址类型的addrtype”。
`Enumeration<RefAddr>`	`getAll()` 检索此引用中的地址的枚举数。
`String`	`getClassName()` 检索此引用所引用的对象的类名称。
`String`	`getFactoryClassLocation()` 检索此引用所引用的对象的工厂的位置。
`String`	`getFactoryClassName()` 检索此引用所引用的对象的工厂的类名称。
`int`	`hashCode()` 计算此引用的哈希代码。
`Object`	`remove(int posn)` 删除从列表中的地址索引位置的地址。
`int`	`size()` 检索此引用中的地址数。
`String`	`toString()` 生成此引用的字符串表示形式。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - className
```
protected String className
```
    包含此引用所引用的对象的类的完全限定名称。
    
    另请参见：
    
    Class.getName()
  - addrs
```
protected Vector<RefAddr> addrs
```
    包含此引用中包含的地址。由构造函数初始化。
  - classFactory
```
protected String classFactory
```
    包含用于创建此引用引用的对象的实例的工厂类的名称。初始化为空。
  - classFactoryLocation
```
protected String classFactoryLocation
```
    包含工厂类的位置。初始化为空。
- Constructor Detail
  - Reference
```
public Reference(String className)
```
    为建立具有类名称的类名对象的一个新的参考”。类工厂和类工厂位置设置为空。新创建的引用包含零地址。
    
    参数
    
    className -非空类对象的名称，这个参考指。
  - Reference
```
public Reference(String className,
                 RefAddr addr)
```
    构建与类的名字“类名”和一个地址的对象的一个新的参考。类工厂和类工厂位置设置为空。
    
    参数
    
    className -非空类对象的名称，这个参考指。
    
    addr -对象的非空地址。
  - Reference
```
public Reference(String className,
                 String factory,
                 String factoryLocation)
```
    构建与类的名字“类名”对象的一个新的参考，和类的名称和对象的工厂位置。
    
    参数
    
    className -非空类对象的名称，这个参考指。
    
    factory -对象的工厂可能的空类的名称。
    
    factoryLocation -从加载工厂可能的空位置（例如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 -非空类对象的名称，这个参考指。
    
    factory -对象的工厂可能的空类的名称。
    
    factoryLocation -从加载工厂可能的空位置（例如URL）
    
    addr -对象的非空地址。
    
    另请参见：
    
    ObjectFactory， NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)
- 方法详细信息
  - getClassName
```
public String getClassName()
```
    检索此引用所引用的对象的类名称。
    
    结果
    
    对象的非空完全限定的类名称。（如“java。lang.string”）
  - getFactoryClassName
```
public String getFactoryClassName()
```
    检索此引用所引用的对象的工厂的类名称。
    
    结果
    
    工厂可能的空完全合格的类名称。（如“java。lang.string”）
  - getFactoryClassLocation
```
public String getFactoryClassLocation()
```
    检索此引用所引用的对象的工厂的位置。如果它是一个代码库，然后是URL的有序列表，以空格分隔，上市地点从工厂类定义应装。
    
    结果
    
    包含在工厂类中加载位置的可能的空字符串。
  - get
```
public RefAddr get(String addrType)
```
    获取第一个地址，地址类型的addrtype”。字符串。compareto()是用来测试的地址类型的平等。
    
    参数
    
    addrType -非零地址类型，找到地址。
    
    结果
    
    本文参考地址类型“addrtype地址；如果不存在这样的地址无效。
  - get
```
public RefAddr get(int posn)
```
    在索引中检索输入的地址。
    
    参数
    
    posn -地址检索索引。
    
    结果
    
    在0的索引位置的地址。它必须在范围[ 0，getaddresscount()）。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置不在指定的范围内的。
  - getAll
```
public Enumeration<RefAddr> getAll()
```
    检索此引用中的地址的枚举数。当添加了地址，更改或删除此引用时，其对此枚举的影响是不确定的。
    
    结果
    
    该地址的非零计数（ RefAddr）本参考。如果此引用具有零地址，则返回一个零元素的枚举。
  - size
```
public int size()
```
    检索此引用中的地址数。
    
    结果
    
    此参考中的地址的非负数。
  - add
```
public void add(RefAddr addr)
```
    在地址列表的结尾添加一个地址。
    
    参数
    
    addr -非零地址添加。
  - add
```
public void add(int posn,
                RefAddr addr)
```
    添加一个地址到地址列表索引位置。所有的地址索引位置或更大的转移的名单由一个（离指数0）。
    
    参数
    
    posn - 0开始索引列表的插入地址。
    
    addr -非零地址添加。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置不在指定的范围内的。
  - remove
```
public Object remove(int posn)
```
    删除从列表中的地址索引位置的地址。所有地址在指数大于位置移到列表的一个（对指数0）。
    
    参数
    
    posn - 0索引地址删除。
    
    结果
    
    删除地址。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置不在指定的范围内的。
  - clear
```
public void clear()
```
    从这个引用中删除所有地址。
  - equals
```
public boolean equals(Object obj)
```
    确定目标是一个具有相同地址的引用（在相同的顺序）作为参考。地址refaddr equals()检查使用。除了具有相同的地址，参考还需要具有相同的类名称作为此参考。没有检查类工厂和类工厂位置。如果obj是无效的或不引用实例，则返回null。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -检查可能的空对象。
    
    结果
    
    如果obj等于参考真；否则为false。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    计算此引用的哈希代码。哈希代码是它的地址的哈希代码的总和。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    哈希代码的参考为int型。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    生成此引用的字符串表示形式。该字符串由该引用所指的类名称和其每个地址的字符串表示形式组成。此表示仅用于显示，而不需要解析。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    此引用的非空字符串表示形式。
  - clone
```
public Object clone()
```
    使用它的地址类名称列表、类工厂名称和类工厂位置的引用的副本。对新创建的副本的更改不影响此引用，反之亦然。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这个实例的克隆。
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Reference

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

className

addrs

classFactory

classFactoryLocation

Constructor Detail

Reference

Reference

Reference

Reference

方法详细信息

getClassName

getFactoryClassName

getFactoryClassLocation

get

get

getAll

size

add

add

remove

clear

equals

hashCode

toString

clone