Интерфейс атрибутов

public interface Attributes
extends Cloneable, Serializable

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

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

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

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

Методы

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

Возвращает:

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

См. также:

remove(java.lang.String)

put

Attribute put(Attribute attr)

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

Параметры:

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

Возвращает:

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

См. также:

remove(java.lang.String)

remove

Attribute remove(String attrID)

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

Параметры:

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

Возвращает:

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

clone

Object clone()

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

Возвращает:

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