Класс BasicAttributes

java.lang.Object

javax.naming.directory.BasicAttributes

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

public class BasicAttributes extends Object implements Attributes

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

BasicAttributes учитывает или не учитывает регистр (case-ignore). Это свойство определяется при вызове конструктора 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

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

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 — ненулевой идентификатор добавляемого атрибута. Если набор атрибутов игнорирует регистр символов идентификаторов атрибутов, регистр 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/directory/BasicAttributes.html