Справочник по классу

java.lang.Object

javax.naming.Reference

Все реализуемые интерфейсы:: Serializable, Cloneable

Непосредственные подклассы:: LinkRef

public class Reference extends Object implements Cloneable, Serializable

Этот класс представляет ссылку на объект, находящийся вне системы именования/каталогов.

Reference предоставляет способ записи адресной информации об объектах, которые сами по себе не связаны напрямую с системой именования/каталогов.

Reference состоит из упорядоченного списка адресов и информации о классе объекта, на который указывает ссылка. Каждый адрес в списке идентифицирует конечную точку связи для одного и того же концептуального объекта. «Конечная точка связи» — это информация, указывающая, как связаться с объектом. Например, это может быть сетевой адрес, местоположение в памяти локального компьютера, другой процесс на том же компьютере и т. д. Порядок адресов в списке может иметь значение для фабрик объектов, интерпретирующих ссылку.

Несколько адресов могут быть указаны по разным причинам, например, из-за репликации или предоставления объектом интерфейсов через несколько механизмов связи. Индексация адресов начинается с нуля.

Reference также содержит информацию, помогающую создать экземпляр объекта, на который указывает эта Reference. Она содержит имя класса этого объекта, а также имя и местоположение фабрики, используемой для создания объекта. Местоположение фабрики классов представляет собой разделенный пробелами список URL-адресов, соответствующий пути классов, используемому для загрузки фабрики. Когда необходимо загрузить класс фабрики (или любой класс либо ресурс, от которого он зависит), предпринимается попытка загрузить класс с использованием каждого URL-адреса по порядку.

Экземпляр Reference не защищен от одновременного доступа нескольких потоков. Потоки, которым необходимо одновременно обращаться к одному экземпляру Reference, должны синхронизироваться между собой и обеспечивать необходимую блокировку.

Начиная с:

1.3

См. также:

Краткое описание полей

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

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

className

protected String className

Содержит полное имя класса объекта, на который указывает эта Reference.

См. также:

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)

См. также:

Reference

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

Создает новую ссылку на объект с именем класса 'className', именем и местоположением фабрики объекта, а также адресом объекта.

Параметры:

className — Имя класса объекта, на который указывает эта ссылка; не должно быть null.

addr — Адрес объекта; не должен быть null.

factory — Возможно, null; имя класса фабрики объекта.

factoryLocation — Возможно, null; местоположение, откуда следует загрузить фабрику (например, URL)

См. также:

Подробное описание методов

getClassName

public String getClassName()

Возвращает имя класса объекта, на который указывает эта ссылка.

Возвращает:: Полное имя класса объекта; не должно быть null (например, "java.lang.String")

getFactoryClassName

public String getFactoryClassName()

Возвращает имя класса фабрики объекта, на который указывает эта ссылка.

Возвращает:: Возможно, null; полное имя класса фабрики (например, "java.lang.String")

getFactoryClassLocation

public String getFactoryClassLocation()

Возвращает местоположение фабрики объекта, на который указывает эта ссылка. Если это кодовая база, то она представляет собой упорядоченный список разделенных пробелами URL-адресов, указывающих местоположения, откуда следует загружать определение класса фабрики.

Возвращает:: Возможно, null; строка, содержащая местоположение для загрузки класса фабрики.

get

public RefAddr get(String addrType)

Возвращает первый адрес с типом адреса 'addrType'. Для проверки совпадения типов адресов используется String.compareTo().

Параметры:: addrType — Тип адреса, для которого требуется найти адрес; не должен быть null.
Возвращает:: Адрес в этой ссылке с типом адреса 'addrType'; null, если такого адреса нет.

get

public RefAddr get(int posn)

Возвращает адрес по индексу posn.

Параметры:: posn — Индекс возвращаемого адреса.
Возвращает:: Адрес по индексу posn, отсчитываемому от нуля. Он должен находиться в диапазоне [0,getAddressCount()).
Выбрасывает:: ArrayIndexOutOfBoundsException — Если posn не входит в указанный диапазон.

getAll

public Enumeration<RefAddr> getAll()

Возвращает перечисление адресов в этой ссылке. Если адреса в этой ссылке добавляются, изменяются или удаляются, влияние этих изменений на перечисление не определено.

Возвращает:: Перечисление адресов (RefAddr) в этой ссылке; не должно быть null. Если эта ссылка не содержит адресов, возвращается перечисление с нулевым количеством элементов.

size

public int size()

Возвращает количество адресов в этой ссылке.

Возвращает:: Неотрицательное количество адресов в этой ссылке.

add

public void add(RefAddr addr)

Добавляет адрес в конец списка адресов.

Параметры:: addr — Добавляемый адрес; не должен быть null.

add

public void add(int posn, RefAddr addr)

Добавляет адрес в список адресов по индексу posn. Все адреса с индексом posn или выше сдвигаются на одну позицию вверх по списку (в сторону от индекса 0).

Параметры:: posn — Индекс списка, отсчитываемый от нуля, по которому вставляется addr.; addr — Добавляемый адрес; не должен быть null.
Выбрасывает:: ArrayIndexOutOfBoundsException — Если posn не входит в указанный диапазон.

remove

public Object remove(int posn)

Удаляет адрес по индексу posn из списка адресов. Все адреса с индексом больше posn сдвигаются на одну позицию вниз по списку (в сторону индекса 0).

Параметры:: posn — Индекс удаляемого адреса, отсчитываемый от нуля.
Возвращает:: Удаленный адрес.
Выбрасывает:: ArrayIndexOutOfBoundsException — Если posn не входит в указанный диапазон.

clear

public void clear()

Удаляет все адреса из этой ссылки.

equals

public boolean equals(Object obj)

Определяет, является ли obj ссылкой с теми же адресами (в том же порядке), что и эта ссылка. Адреса сравниваются с помощью RefAddr.equals(). Помимо совпадения адресов, Reference должна иметь то же имя класса, что и эта ссылка. Фабрика классов и местоположение фабрики классов не проверяются. Если obj равен null или не является экземпляром Reference, возвращается null.

Переопределяет:

equals в классе Object

Параметры:

obj — Проверяемый объект; возможно, null.

Возвращает:

true, если obj равен этой ссылке; в противном случае false.

См. также:

hashCode

public int hashCode()

Вычисляет хеш-код этой ссылки. Хеш-код представляет собой сумму хеш-кодов ее адресов.

Переопределяет:

hashCode в классе Object

Возвращает:

Хеш-код этой ссылки типа int.

См. также:

toString

public String toString()

Создает строковое представление этой ссылки. Строка состоит из имени класса, на который указывает эта ссылка, и строкового представления каждого из ее адресов. Это представление предназначено только для отображения и не предназначено для разбора.

Переопределяет:: toString в классе Object
Возвращает:: Строковое представление этой ссылки; не должно быть null.

clone

public Object clone()

Создает копию этой ссылки, используя имя ее класса, список адресов, имя фабрики классов и местоположение фабрики классов. Изменения в созданной копии не влияют на эту Reference и наоборот.

Переопределяет:

clone в классе Object

Возвращает:

клон этого экземпляра.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.