Ссылка (Платформа Java SE 7)

java.lang. Объект
- javax.naming. Ссылка

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

Прямые Известные Подклассы:

LinkRef
```
public class Reference
extends Object
implements Cloneable, Serializable
```
Этот класс представляет ссылку на объект, который находится за пределами именования/системы каталогов.
Ссылка обеспечивает способ записать информацию об адресах об объектах, которые непосредственно непосредственно не связываются с именованием/системой каталогов.
Ссылка состоит из упорядоченного списка адресов и информации о классе о ссылаемом объекте. Каждый адрес в списке идентифицирует коммуникационную конечную точку для того же самого концептуального объекта. "Коммуникационная конечная точка" является информацией, которая указывает, как связаться с объектом. Это мог быть, например, сетевой адрес, расположение в памяти на локальной машине, другом процессе на той же самой машине, и т.д. Порядок адресов в списке может иметь значение возразить фабрикам, которые интерпретируют ссылку.
Многократные адреса могут возникнуть по различным причинам, таким как репликация или интерфейсы предложения объекта свыше больше чем одного коммуникационного механизма. Адреса индексируются, запускаясь с нуля.
Ссылка также содержит информацию, чтобы помочь в создании экземпляра объекта, к которому обращается эта Ссылка. Это содержит имя класса того объекта, и имя класса и расположение фабрики, которая будет использоваться, чтобы создать объект. Расположение фабрики классов является разделенным пробелом списком URL, представляющих путь к классу, используемый, чтобы загрузить фабрику. Когда класс фабрики (или любой класс или ресурс, от которого это зависит) должны быть загружены, каждый URL используется (чтобы) попытаться загрузить класс.
Ссылочный экземпляр не синхронизируется против параллельного доступа многократными потоками. Потоки, которые должны получить доступ к единственной Ссылке одновременно, должны синхронизироваться среди себя и обеспечить необходимую блокировку.

С тех пор:

1.3

См. Также:
RefAddr, StringRefAddr, BinaryRefAddr, Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected Vector<RefAddr>`	`addrs` Содержит адреса, содержавшиеся в этой Ссылке.
`protected String`	`classFactory` Содержит имя класса фабрики для того, чтобы создать экземпляр объекта, к которому обращается эта Ссылка.
`protected String`	`classFactoryLocation` Содержит расположение класса фабрики.
`protected String`	`имя класса` Содержит полностью определенное имя класса объекта, к которому обращается эта Ссылка.

Сводка конструктора

Конструкторы
Конструктор и Описание
`Reference(String className)` Создает новую ссылку для объекта с именем класса 'имя класса'.
`Reference(String className, RefAddr addr)` Создает новую ссылку для объекта с именем класса 'имя класса' и адрес.
`Reference(String className, RefAddr addr, String factory, String factoryLocation)` Создает новую ссылку для объекта с именем класса 'имя класса', имя класса и расположение фабрики объекта, и адрес для объекта.
`Reference(String className, String factory, String factoryLocation)` Создает новую ссылку для объекта с именем класса 'имя класса', и имя класса и расположение фабрики объекта.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`add(int posn, RefAddr addr)` Добавляет адрес к списку адресов по индексу posn.
`void`	`add(RefAddr addr)` Добавляет адрес до конца списка адресов.
`void`	`clear()` Удаляет все адреса из этой ссылки.
`Объект`	`clone()` Делает копию этой ссылки, используя ее список имени класса адресов, имени фабрики классов и расположения фабрики классов.
`boolean`	`equals(Object obj)` Определяет, является ли obj ссылкой с теми же самыми адресами (в том же самом порядке) как эта ссылка.
`RefAddr`	`get(int posn)` Получает адрес по индексу posn.
`RefAddr`	`get(String addrType)` Получает первый адрес, у которого есть тип адреса 'addrType'.
`Enumeration<RefAddr>`	`getAll()` Получает перечисление адресов в этой ссылке.
`Строка`	`getClassName()` Получает имя класса объекта, к которому обращается эта ссылка.
`Строка`	`getFactoryClassLocation()` Получает расположение фабрики объекта, к которому обращается эта ссылка.
`Строка`	`getFactoryClassName()` Получает имя класса фабрики объекта, к которому обращается эта ссылка.
`int`	`hashCode()` Вычисляет хэш-код этой ссылки.
`Объект`	`remove(int posn)` Удаляет адрес по индексу posn от списка адресов.
`int`	`size()` Получает число адресов в этой ссылке.
`Строка`	`toString()` Генерирует строковое представление этой ссылки.

Методы java.lang унаследованный от класса. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - имя класса
```
protected String className
```
    Содержит полностью определенное имя класса объекта, к которому обращается эта Ссылка.
    
    См. Также:
    Class.getName()
  - addrs
```
protected Vector<RefAddr> addrs
```
    Содержит адреса, содержавшиеся в этой Ссылке. Инициализированный конструктором.
  - classFactory
```
protected String classFactory
```
    Содержит имя класса фабрики для того, чтобы создать экземпляр объекта, к которому обращается эта Ссылка. Инициализированный к нулю.
  - classFactoryLocation
```
protected String classFactoryLocation
```
    Содержит расположение класса фабрики. Инициализированный к нулю.
- Деталь конструктора
  - Ссылка
```
public Reference(String className)
```
    Создает новую ссылку для объекта с именем класса 'имя класса'. Фабрика классов и расположение фабрики классов, устанавливают в NULL. Недавно создаваемая ссылка содержит нулевые адреса.
    
    Параметры:
    className - Ненулевое имя класса объекта, к которому обращается эта ссылка.
  - Ссылка
```
public Reference(String className,
         RefAddr addr)
```
    Создает новую ссылку для объекта с именем класса 'имя класса' и адрес. Фабрика классов и расположение фабрики классов, устанавливают в NULL.
    
    Параметры:
    className - Ненулевое имя класса объекта, к которому обращается эта ссылка.
    addr - Ненулевой адрес объекта.
  - Ссылка
```
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<?, ?>)
  - Ссылка
```
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. Строка")
  - getFactoryClassName
```
public String getFactoryClassName()
```
    Получает имя класса фабрики объекта, к которому обращается эта ссылка.
    
    Возвраты:
    Возможно нуль полностью определенное имя класса фабрики. (например, "java.lang. Строка")
  - getFactoryClassLocation
```
public String getFactoryClassLocation()
```
    Получает расположение фабрики объекта, к которому обращается эта ссылка. Если это - кодовая база, то это - упорядоченный список URL, разделенных пробелами, перечисляя расположения от того, где определение класса фабрики должно быть загружено.
    
    Возвраты:
    Возможно пустая строка, содержащая расположение для того, чтобы загрузиться в классе фабрики.
  - добраться
```
public RefAddr get(String addrType)
```
    Получает первый адрес, у которого есть тип адреса 'addrType'. String.compareTo () используется, чтобы протестировать равенство типов адреса.
    
    Параметры:
    addrType - Ненулевой адрес вводит, для которого можно найти адрес.
    
    Возвраты:
    Адрес в этой ссылке с адресом вводит 'addrType; нуль, если никакой такой адрес не существует.
  - добраться
```
public RefAddr get(int posn)
```
    Получает адрес по индексу posn.
    
    Параметры:
    posn - Индекс адреса, чтобы получить.
    
    Возвраты:
    Адрес по индексу на основе 0 posn. Это должно быть в диапазоне [0, getAddressCount ()).
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn не в указанном диапазоне.
  - getAll
```
public Enumeration<RefAddr> getAll()
```
    Получает перечисление адресов в этой ссылке. Когда адреса добавляются, изменили или удалили из этой ссылки, ее эффекты на это перечисление неопределены.
    
    Возвраты:
    Ненулевое перечисление адресов (RefAddr) в этой ссылке. Если у этой ссылки есть нулевые адреса, перечисление с нулевыми элементами возвращается.
  - размер
```
public int size()
```
    Получает число адресов в этой ссылке.
    
    Возвраты:
    Неотрицательное число адресов в этой ссылке.
  - добавить
```
public void add(RefAddr addr)
```
    Добавляет адрес до конца списка адресов.
    
    Параметры:
    addr - Ненулевой адрес, чтобы добавить.
  - добавить
```
public void add(int posn,
       RefAddr addr)
```
    Добавляет адрес к списку адресов по индексу posn. Все адреса по индексу posn или больше смещаются список одним (далеко от индекса 0).
    
    Параметры:
    posn - Индекс на основе 0 списка, чтобы вставить addr.
    addr - Ненулевой адрес, чтобы добавить.
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn не в указанном диапазоне.
  - удалить
```
public Object remove(int posn)
```
    Удаляет адрес по индексу posn от списка адресов. Все адреса по индексу, больше чем posn, смещаются вниз список одним (к индексу 0).
    
    Параметры:
    posn - Индекс на основе 0 в адресе, чтобы удалить.
    
    Возвраты:
    Адрес удаляется.
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn не в указанном диапазоне.
  - очистить
```
public void clear()
```
    Удаляет все адреса из этой ссылки.
  - равняется
```
public boolean equals(Object obj)
```
    Определяет, является ли obj ссылкой с теми же самыми адресами (в том же самом порядке) как эта ссылка. Адреса проверяются, используя RefAddr.equals (). В дополнение к наличию тех же самых адресов у Ссылки также должно быть то же самое имя класса как эта ссылка. Фабрика классов и расположение фабрики классов не проверяются. Если obj является нулем или не экземпляром Ссылки, нуль возвращается.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    obj - Возможно нуль возражают, чтобы проверить.
    
    Возвраты:
    истина, если obj равен этой ссылке; ложь иначе.
    См. Также:
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Вычисляет хэш-код этой ссылки. Хэш-код является суммой хэш-кода ее адресов.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    Хэш-код этой ссылки как интервал.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Генерирует строковое представление этой ссылки. Строка состоит из имени класса, к которому эта ссылка обращается, и строковое представление каждого из его адресов. Это представление предназначается для дисплея только а не быть проанализированным.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Представление непустой строки этой ссылки.
  - клон
```
public Object clone()
```
    Делает копию этой ссылки, используя ее список имени класса адресов, имени фабрики классов и расположения фабрики классов. Изменения к недавно создаваемой копии не влияют на эту Ссылку и наоборот.
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    клон этого экземпляра.
    См. Также:
    Cloneable

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Ссылка класса

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

имя класса

addrs

classFactory

classFactoryLocation

Деталь конструктора

Ссылка

Ссылка

Ссылка

Ссылка

Деталь метода

getClassName

getFactoryClassName

getFactoryClassLocation

добраться

добраться

getAll

размер

добавить

добавить

удалить

очистить

равняется

хэш-код

toString

клон