Класс BasicAttributes

java.lang.Object

javax.naming.directory.BasicAttributes

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

public class BasicAttributes extends Object implements Attributes

Этот класс предоставляет базовую реализацию интерфейса Attributes.

BasicAttributes может быть чувствительным или нечувствительным к регистру символов (игнорировать регистр). Это свойство определяется при вызове конструктора BasicAttributes. В BasicAttributes, нечувствительном к регистру, регистр символов идентификаторов атрибутов игнорируется при поиске атрибута или добавлении атрибутов. В BasicAttributes, чувствительном к регистру, регистр имеет значение.

Когда классу BasicAttributes требуется создать Attribute, он использует BasicAttribute. Других зависимостей от BasicAttribute нет.

Обратите внимание, что обновления BasicAttributes (например, добавление или удаление атрибута) не влияют на соответствующее представление в каталоге. Обновить каталог можно только с помощью операций интерфейса DirContext.

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

Начиная с:

1.3

См. также:

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

Конструктор	Описание
`BasicAttributes()`	Создает новый экземпляр Attributes.
`BasicAttributes(boolean ignoreCase)`	Создает новый экземпляр Attributes.
`BasicAttributes(String attrID, Object val)`	Создает новый экземпляр Attributes с одним атрибутом.
`BasicAttributes(String attrID, Object val, boolean ignoreCase)`	Создает новый экземпляр Attributes с одним атрибутом.

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создает копию набора атрибутов.
`boolean`	`equals(Object obj)`	Определяет, равен ли этот `BasicAttributes` другому `Attributes` Два `Attributes` равны, если оба являются экземплярами `Attributes`, одинаково учитывают регистр идентификаторов атрибутов и содержат одинаковые атрибуты.
`Attribute`	`get(String attrID)`	Извлекает атрибут с указанным идентификатором из набора атрибутов.
`NamingEnumeration<Attribute>`	`getAll()`	Извлекает перечисление атрибутов из набора атрибутов.
`NamingEnumeration<String>`	`getIDs()`	Извлекает перечисление идентификаторов атрибутов из набора атрибутов.
`int`	`hashCode()`	Вычисляет хеш-код этого BasicAttributes.
`boolean`	`isCaseIgnored()`	Определяет, игнорирует ли набор атрибутов регистр идентификаторов атрибутов при извлечении или добавлении атрибутов.
`Attribute`	`put(String attrID, Object val)`	Добавляет новый атрибут в набор атрибутов.
`Attribute`	`put(Attribute attr)`	Добавляет новый атрибут в набор атрибутов.
`Attribute`	`remove(String attrID)`	Удаляет из набора атрибутов атрибут с идентификатором 'attrID'.
`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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения указанного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения указанного времени.

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

BasicAttributes

public BasicAttributes()

Создает новый экземпляр Attributes. При последующем извлечении или добавлении атрибутов регистр символов идентификаторов атрибутов учитывается.

BasicAttributes

public BasicAttributes(boolean ignoreCase)

Создает новый экземпляр Attributes. Если ignoreCase имеет значение true, регистр символов идентификаторов атрибутов игнорируется; в противном случае он учитывается.

Параметры:: ignoreCase — true означает, что этот набор атрибутов будет игнорировать регистр символов идентификаторов атрибутов при извлечении или добавлении атрибутов; false означает, что регистр учитывается.

BasicAttributes

public BasicAttributes(String attrID, Object val)

Создает новый экземпляр Attributes с одним атрибутом. Атрибут, заданный параметрами attrID и val, добавляется в только что созданный набор атрибутов. При последующем извлечении или добавлении атрибутов регистр символов идентификаторов атрибутов учитывается.

Параметры:: attrID — не null. Идентификатор добавляемого атрибута.; val — значение добавляемого атрибута. Если значение равно null, атрибуту присваивается значение null.

BasicAttributes

public BasicAttributes(String attrID, Object val, boolean ignoreCase)

Создает новый экземпляр Attributes с одним атрибутом. Атрибут, заданный параметрами attrID и val, добавляется в только что созданный набор атрибутов. Если ignoreCase имеет значение true, регистр символов идентификаторов атрибутов игнорируется; в противном случае он учитывается.

Параметры:: attrID — не null. Идентификатор добавляемого атрибута. Если этот набор атрибутов игнорирует регистр символов идентификаторов атрибутов, регистр attrID игнорируется.; val — значение добавляемого атрибута. Если значение равно null, атрибуту присваивается значение null.; ignoreCase — true означает, что этот набор атрибутов будет игнорировать регистр символов идентификаторов атрибутов при извлечении или добавлении атрибутов; false означает, что регистр учитывается.

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

clone

public Object clone()

Описание скопировано из интерфейса: Attributes

Создает копию набора атрибутов. Новый набор содержит те же атрибуты, что и исходный: сами атрибуты не клонируются. Изменения копии не влияют на оригинал, и наоборот.

Определено в:

clone в интерфейсе Attributes

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

clone в классе Object

Возвращает:

Ненулевую копию этого набора атрибутов.

См. также:

isCaseIgnored

public boolean isCaseIgnored()

Описание скопировано из интерфейса: Attributes

Определяет, игнорирует ли набор атрибутов регистр идентификаторов атрибутов при извлечении или добавлении атрибутов.

Определено в:: isCaseIgnored в интерфейсе Attributes
Возвращает:: true, если регистр игнорируется; в противном случае false.

size

public int size()

Описание скопировано из интерфейса: Attributes

Возвращает количество атрибутов в наборе атрибутов.

Определено в:: size в интерфейсе Attributes
Возвращает:: Неотрицательное количество атрибутов в этом наборе атрибутов.

get

public Attribute get(String attrID)

Описание скопировано из интерфейса: Attributes

Извлекает атрибут с указанным идентификатором из набора атрибутов.

Определено в:

get в интерфейсе Attributes

Параметры:

attrID — ненулевой идентификатор извлекаемого атрибута. Если этот набор атрибутов игнорирует регистр символов идентификаторов атрибутов, регистр attrID игнорируется.

Возвращает:

Атрибут с идентификатором attrID; null, если он не найден.

См. также:

getAll

public NamingEnumeration<Attribute> getAll()

Описание скопировано из интерфейса: Attributes

Извлекает перечисление атрибутов из набора атрибутов. Влияние обновлений этого набора атрибутов на данное перечисление не определено.

Определено в:: getAll в интерфейсе Attributes
Возвращает:: Ненулевое перечисление атрибутов этого набора атрибутов. Каждый элемент перечисления относится к классу Attribute. Если набор атрибутов не содержит атрибутов, возвращается пустое перечисление.

getIDs

public NamingEnumeration<String> getIDs()

Описание скопировано из интерфейса: Attributes

Извлекает перечисление идентификаторов атрибутов из набора атрибутов. Влияние обновлений этого набора атрибутов на данное перечисление не определено.

Определено в:: getIDs в интерфейсе Attributes
Возвращает:: Ненулевое перечисление идентификаторов атрибутов этого набора атрибутов. Каждый элемент перечисления относится к классу String. Если набор атрибутов не содержит атрибутов, возвращается пустое перечисление.

put

public Attribute put(String attrID, Object val)

Описание скопировано из интерфейса: Attributes

Добавляет новый атрибут в набор атрибутов.

Определено в:

put в интерфейсе Attributes

Параметры:

attrID — не null. Идентификатор добавляемого атрибута. Если набор атрибутов игнорирует регистр символов идентификаторов атрибутов, регистр attrID игнорируется.

val — возможно, null, значение добавляемого атрибута. Если значение равно null, атрибут не содержит значений.

Возвращает:

Атрибут с идентификатором attrID, ранее находившийся в этом наборе атрибутов; null, если такого атрибута не было.

См. также:

put

public Attribute put(Attribute attr)

Описание скопировано из интерфейса: Attributes

Добавляет новый атрибут в набор атрибутов.

Определено в:

put в интерфейсе Attributes

Параметры:

attr — ненулевой атрибут для добавления. Если набор атрибутов игнорирует регистр символов идентификаторов атрибутов, регистр идентификатора attr игнорируется.

Возвращает:

Атрибут с тем же идентификатором, что и у attr, ранее находившийся в этом наборе атрибутов; null, если такого атрибута не было.

См. также:

remove

public Attribute remove(String attrID)

Описание скопировано из интерфейса: Attributes

Удаляет из набора атрибутов атрибут с идентификатором 'attrID'. Если атрибут не существует, ничего не делает.

Определено в:: remove в интерфейсе Attributes
Параметры:: attrID — ненулевой идентификатор удаляемого атрибута. Если набор атрибутов игнорирует регистр символов идентификаторов атрибутов, регистр attrID игнорируется.
Возвращает:: Атрибут с тем же идентификатором, что и у attrID, ранее находившийся в наборе атрибутов; null, если такого атрибута не было.

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: Ненулевую строку с содержимым этого набора атрибутов.

equals

public boolean equals(Object obj)

Определяет, равен ли этот BasicAttributes другому Attributes Два Attributes равны, если оба являются экземплярами Attributes, одинаково учитывают регистр идентификаторов атрибутов и содержат одинаковые атрибуты. Каждый Attribute в этом BasicAttributes проверяется на равенство с помощью Object.equals(), который может быть переопределен реализациями Attribute). Если подкласс переопределяет equals(), ему также следует переопределить hashCode(), чтобы два равных экземпляра Attributes имели одинаковый хеш-код.

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

equals в классе Object

Параметры:

obj — объект, возможно равный null, с которым выполняется сравнение.

Возвращает:

true, если obj равен этому BasicAttributes.

См. также:

hashCode

public int hashCode()

Вычисляет хеш-код этого BasicAttributes.

Хеш-код вычисляется путем сложения хеш-кодов атрибутов этого объекта. Если этот BasicAttributes игнорирует регистр символов идентификаторов атрибутов, к хеш-коду добавляется единица. Если подкласс переопределяет hashCode(), ему также следует переопределить equals(), чтобы два равных экземпляра Attributes имели одинаковый хеш-код.

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

hashCode в классе Object

Возвращает:

значение типа int, представляющее хеш-код этого экземпляра BasicAttributes.

См. также:

© 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.