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

Все суперинтерфейсы:: 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, если не найден.

См. также:

put(java.lang.String, java.lang.Object)
remove(java.lang.String)

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, если такого атрибута не было.

См. также:

remove(java.lang.String)

put

Attribute put(Attribute attr)

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

Параметры:

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

Возвращает:

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

См. также:

remove(java.lang.String)

remove

Attribute remove(String attrID)

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

Параметры:: attrID - Непустой идентификатор атрибута для удаления. Если набор атрибутов игнорирует регистр идентификаторов атрибутов, регистр attrID игнорируется.
Возвращает:: Атрибут с ID, совпадающим с attrID, который ранее был в наборе атрибутов; null, если такого атрибута не было.

clone

Object clone()

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

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

© 1993, 2021, 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/17/docs/api/java.naming/javax/naming/directory/Attributes.html