Интерфейс 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, атрибут не имеет значений.

Возвращает:

Атрибут с 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, 2023, 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/21/docs/api/java.naming/javax/naming/directory/Attributes.html