Класс BasicAttributes

java.lang.Object

javax.naming.directory.BasicAttributes

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

public class BasicAttributes extends Object implements Attributes

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

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

Когда классу BasicAttributes необходимо создать атрибут, он использует 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()`	Генерирует строковое представление этого набора атрибутов.

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

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

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

Основные атрибуты

public BasicAttributes()

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

Основные атрибуты

public BasicAttributes(boolean ignoreCase)

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

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

Основные атрибуты

public BasicAttributes(String attrID, Object val)

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

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

Основные атрибуты

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

Создаёт новый экземпляр атрибутов с одним атрибутом. Атрибут, заданный 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 - не null идентификатор атрибута для извлечения. Если этот набор атрибутов игнорирует регистр своих идентификаторов атрибутов, регистр 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 - не null добавляемый атрибут. Если набор атрибутов игнорирует регистр своих идентификаторов атрибутов, регистр идентификатора attr игнорируется.

Возвращает:

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

См. также:

remove

public Attribute remove(String attrID)

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

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

Задано:: remove в интерфейсе Attributes
Параметры:: attrID - не null идентификатор удаляемого атрибута. Если набор атрибутов игнорирует регистр своих идентификаторов атрибутов, регистр 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, которые равны, имели одинаковый хэш-код.

Overrides:

equals в классе Object

Parameters:

obj - сравниваемый объект (возможно, null).

Returns:

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

See Also:

hashCode

public int hashCode()

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

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

Overrides:

hashCode в классе Object

Returns:

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

See Also:

© 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/directory/BasicAttributes.html