Spec-Zone.ru › OpenJDK 24

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

java.lang.Object
javax.naming.Reference
Все реализованные интерфейсы:
Serializable, Cloneable
Прямые известные подклассы:
LinkRef
public class Reference extends Object implements Cloneable, Serializable
Этот класс представляет ссылку на объект, который находится вне системы именования/каталога.

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

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

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

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

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

С:
1.3
См. также:
  • RefAddr
  • StringRefAddr
  • BinaryRefAddr
  • Сериализованная форма

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

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

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

Конструктор Описание
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()
Генерирует строковое представление этой ссылки.

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

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

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

className

protected String className
Содержит полное имя класса объекта, к которому относится эта ссылка.
См. также:
  • Class.getName()

addrs

protected Vector<RefAddr> addrs
Содержит адреса, содержащиеся в этой ссылке. Инициализируется конструктором.

classFactory

protected String classFactory
Содержит имя класса фабрики для создания экземпляра объекта, к которому относится эта ссылка. Инициализируется значением null.

classFactoryLocation

protected String classFactoryLocation
Содержит расположение класса фабрики. Инициализируется значением null.

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

Reference

public Reference(String className)
Создаёт новую ссылку на объект с именем класса 'className'. Класс фабрики и расположение класса фабрики устанавливаются в значение null. Созданная ссылка содержит ноль адресов.
Параметры:
className - Непустое имя класса объекта, на который ссылается эта ссылка.

Reference

public Reference(String className, RefAddr addr)
Создаёт новую ссылку на объект с именем класса 'className' и адресом. Класс фабрики и расположение класса фабрики устанавливаются в значение null.
Параметры:
className - Непустое имя класса объекта, на который ссылается эта ссылка.
addr - Непустой адрес объекта.

Reference

public Reference(String className, String factory, String factoryLocation)
Создаёт новую ссылку на объект с именем класса 'className' и именем и местоположением фабрики объекта.
Параметры:
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', именем и расположением фабрики объекта, а также адресом объекта.
Параметры:
className - Непустое имя класса объекта, на который ссылается эта ссылка.
addr - Непустой адрес объекта.
factory - Возможно, пустое имя класса фабрики объекта.
factoryLocation - Возможно, пустое расположение для загрузки фабрики (например, URL)
См. также:
  • 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'. Для проверки равенства типов адресов используется String.compareTo().
Параметры:
addrType - Непустой тип адреса, для которого требуется найти адрес.
Возвращает:
Адрес в этой ссылке с типом адреса 'addrType'; null, если такой адрес не существует.

get

public RefAddr get(int posn)
Возвращает адрес по индексу posn.
Параметры:
posn - Индекс адреса для извлечения.
Возвращает:
Адрес по индексу posn (с нулевой базой). Должен быть в диапазоне [0,getAddressCount()).
Исключения:
ArrayIndexOutOfBoundsException - Если posn не в указанном диапазоне.

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)
Добавляет адрес в список адресов по индексу posn. Все адреса с индексом posn или выше сдвигаются вверх по списку на один (в сторону от индекса 0).
Параметры:
posn - Индекс списка для вставки addr (с нулевой базой).
addr - Непустой адрес для добавления.
Исключения:
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(). Помимо совпадения адресов, ссылка также должна иметь то же имя класса, что и эта ссылка. Класс фабрики и расположение класса фабрики не проверяются. Если obj равен null или не является экземпляром Reference, возвращается null.
Переопределяет:
equals в классе Object
Параметры:
obj - Возможно, нулевой объект для проверки.
Возвращает:
true, если obj равен этой ссылке; иначе false.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Вычисляет хэш-код этой ссылки. Хэш-код является суммой хэш-кодов её адресов.
Переопределяет:
hashCode в классе Object
Возвращает:
Хэш-код этой ссылки в виде int.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)
END_OF_DOCUMENT_MARKER

toString

public String toString()
Генерирует строковое представление этой ссылки. Строка состоит из имени класса, к которому относится эта ссылка, и строкового представления каждого из её адресов. Это представление предназначено только для отображения и не должно анализироваться.
Overrides:
toString в классе Object
Возвращает:
Непустое строковое представление этой ссылки.

clone

public Object clone()
Создаёт копию этой ссылки, используя её имя класса, список адресов, имя фабрики класса и расположение фабрики класса. Изменения в только что созданной копии не влияют на эту ссылку и наоборот.
Overrides:
clone в классе Object
Возвращает:
клон этого экземпляра.
См. также:
  • Cloneable

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/Reference.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API