Spec-Zone.ru › OpenJDK 21

Класс Ссылка

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 - Возможо null имя класса фабрики объекта.
factoryLocation - Возможно null расположение для загрузки фабрики (например, 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 - Возможно null имя класса фабрики объекта.
factoryLocation - Возможно null расположение для загрузки фабрики (например, 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()
Возвращает имя класса фабрики объекта, на который ссылается эта ссылка.
Возвращает:
Возможно null полное имя класса фабрики. (например, "java.lang.String")

getFactoryClassLocation

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

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 - Возможно null объект для проверки.
Возвращает:
true, если 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
Возвращает:
Непустое строковое представление этой ссылки.
END_OF_DOCUMENT_MARKER

clone

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

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.naming/javax/naming/Reference.html

Spec-Zone.ru

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