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

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

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

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

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

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

С тех пор:

1.3

См. Также:

RefAddr, StringRefAddr, BinaryRefAddr, Сериализированная Форма

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

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

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

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

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

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

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

- Полевая Деталь
  - имя класса
```
protected String className
```
    Содержит полностью определенное имя class объекта, к которому обращается эта Ссылка.
    
    См. Также:
    
    Class.getName()
  - addrs
```
protected Vector<RefAddr> addrs
```
    Содержит адреса, содержавшиеся в этой Ссылке. Инициализированный конструктором.
  - classFactory
```
protected String classFactory
```
    Содержит имя фабрики class для того, чтобы создать экземпляр объекта, к которому обращается эта Ссылка. Инициализированный к нулю.
  - classFactoryLocation
```
protected String classFactoryLocation
```
    Содержит расположение фабрики class. Инициализированный к нулю.
- Деталь конструктора
  - Ссылка
```
public Reference(String className)
```
    Создает новую ссылку для объекта с 'именем класса' имени class. Фабрика классов и расположение фабрики class, устанавливают в NULL. Недавно создаваемая ссылка содержит нулевые адреса.
    
    Параметры:
    
    className - Ненулевое имя class объекта, к которому обращается эта ссылка.
  - Ссылка
```
public Reference(String className,
                 RefAddr addr)
```
    Создает новую ссылку для объекта с 'именем класса' имени class и адресом. Фабрика классов и расположение фабрики class, устанавливают в NULL.
    
    Параметры:
    
    className - Ненулевое имя class объекта, к которому обращается эта ссылка.
    
    addr - Ненулевой адрес объекта.
  - Ссылка
```
public Reference(String className,
                 String factory,
                 String factoryLocation)
```
    Создает новую ссылку для объекта с 'именем класса' имени class, и название и местоположение class фабрики объекта.
    
    Параметры:
    
    className - Ненулевое имя class объекта, к которому обращается эта ссылка.
    
    factory - Возможно нулевое имя class фабрики объекта.
    
    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)
```
    Создает новую ссылку для объекта с 'именем класса' имени class, названием и местоположением class фабрики объекта, и адресом для объекта.
    
    Параметры:
    
    className - Ненулевое имя class объекта, к которому обращается эта ссылка.
    
    factory - Возможно нулевое имя class фабрики объекта.
    
    factoryLocation - Возможно нулевое расположение, из которого можно загрузить фабрику (например, URL)
    
    addr - Ненулевой адрес объекта.
    
    См. Также:
    
    ObjectFactory, NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)
- Деталь метода
  - getClassName
```
public String getClassName()
```
    Получает имя class объекта, к которому обращается эта ссылка.
    
    Возвраты:
    
    Ненуль полностью определенное имя class объекта. (например, "java.lang. Строка")
  - getFactoryClassName
```
public String getFactoryClassName()
```
    Получает имя class фабрики объекта, к которому обращается эта ссылка.
    
    Возвраты:
    
    Возможно нуль полностью определенное имя class фабрики. (например, "java.lang. Строка")
  - getFactoryClassLocation
```
public String getFactoryClassLocation()
```
    Получает расположение фабрики объекта, к которому обращается эта ссылка. Если это - кодовая база, то это - упорядоченный список URL, разделенных пробелами, перечисляя расположения от того, где фабрика определение class должна быть загружена.
    
    Возвраты:
    
    Возможно пустая строка, содержащая расположение для того, чтобы загрузиться в class фабрики.
  - добраться
```
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 (). В дополнение к наличию тех же самых адресов у Ссылки также должно быть то же самое имя class как эта ссылка. Фабрика class и расположение фабрики class не проверяются. Если obj является нулем или не экземпляром Ссылки, нуль возвращается.
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    obj - Возможно нуль возражают, чтобы проверить.
    
    Возвраты:
    
    истина, если obj равен этой ссылке; ложь иначе.
    
    См. Также:
    
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Вычисляет хэш-код этой ссылки. Хэш-код является суммой хэш-кода ее адресов.
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    Хэш-код этой ссылки как интервал.
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Генерирует строковое представление этой ссылки. Строка состоит из имени class, к которому эта ссылка обращается, и строковое представление каждого из его адресов. Это представление предназначается для дисплея только а не быть проанализированным.
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    Представление непустой строки этой ссылки.
  - клон
```
public Object clone()
```
    Делает копию этой ссылки, используя ее список имени class адресов, имени фабрики class и расположения фабрики class. Изменения к недавно создаваемой копии не влияют на эту Ссылку и наоборот.
    
    Переопределения:
    
    clone в class Object
    
    Возвраты:
    
    клон этого экземпляра.
    
    См. Также:
    
    Cloneable

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

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

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

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

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

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

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

имя класса

addrs

classFactory

classFactoryLocation

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

Ссылка

Ссылка

Ссылка

Ссылка

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

getClassName

getFactoryClassName

getFactoryClassLocation

добраться

добраться

getAll

размер

добавить

добавить

удалить

очистить

равняется

хэш-код

toString

клон