Интерфейс Attributes

Все суперинтерфейсы:: 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-значение добавляемого атрибута. Если null, атрибут не имеет значений.

Возвращает:

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

См. также:

put

Attribute put(Attribute attr)

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

Параметры:

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

Возвращает:

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

См. также:

remove

Attribute remove(String attrID)

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

Параметры:: attrID - Не нулевой идентификатор атрибута для удаления. Если набор атрибутов игнорирует регистр своих идентификаторов атрибутов, регистр attrID игнорируется.
Возвращает:: Атрибут с таким же ID, как 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://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/directory/Attributes.html