Атрибуты интерфейса

Все суперинтерфейсы:: Cloneable, Serializable

Все известные реализующие классы:: BasicAttributes

public interface Attributes extends Cloneable, Serializable

Этот интерфейс представляет собой набор атрибутов.

В каталоге с именованными объектами могут быть связаны атрибуты. Интерфейс Attributes представляет собой набор атрибутов. Например, можно запросить у каталога атрибуты, связанные с объектом. Эти атрибуты возвращаются в объекте, реализующем интерфейс Attributes.

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

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

С момента выпуска:

1.3

См. также:

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создает копию набора атрибутов.
`Attribute`	`get(String attrID)`	Извлекает атрибут с указанным идентификатором из набора атрибутов.
`NamingEnumeration<? extends Attribute>`	`getAll()`	Извлекает перечисление атрибутов из набора атрибутов.
`NamingEnumeration<String>`	`getIDs()`	Извлекает перечисление идентификаторов атрибутов из набора атрибутов.
`boolean`	`isCaseIgnored()`	Определяет, игнорирует ли набор атрибутов регистр идентификаторов атрибутов при извлечении или добавлении атрибутов.
`Attribute`	`put(String attrID, Object val)`	Добавляет новый атрибут в набор атрибутов.
`Attribute`	`put(Attribute attr)`	Добавляет новый атрибут в набор атрибутов.
`Attribute`	`remove(String attrID)`	Удаляет из набора атрибутов атрибут с идентификатором 'attrID'.
`int`	`size()`	Извлекает количество атрибутов в наборе атрибутов.

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

isCaseIgnored

boolean isCaseIgnored()

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

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

size

int size()

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

Возвращает:: Неотрицательное количество атрибутов в этом наборе атрибутов.

get

Attribute get(String attrID)

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

Параметры:

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

Возвращает:

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

См. также:

getAll

NamingEnumeration<? extends Attribute> getAll()

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

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

getIDs

NamingEnumeration<String> getIDs()

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

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

put

Attribute put(String attrID, Object val)

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

Параметры:

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

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

Возвращает:

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

См. также:

put

Attribute put(Attribute attr)

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

Параметры:

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

Возвращает:

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

См. также:

remove

Attribute remove(String attrID)

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

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

clone

Object clone()

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

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

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