compact3

javax.naming.directory

Класс BasicAttributes

java.lang. Объект

javax.naming.directory. BasicAttributes

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Атрибуты

public class BasicAttributes
extends Object
implements Attributes

Этот class обеспечивает основную реализацию интерфейса Атрибутов.

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

Когда BasicAttributes, class должен создать Атрибут, он использует BasicAttribute. Нет никакой другой зависимости от BasicAttribute.

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

Экземпляр BasicAttributes не синхронизируется против параллельного многопоточного доступа. Многократные потоки, пытающиеся получить доступ и изменить единственный экземпляр BasicAttributes, должны заблокировать объект.

С тех пор:

1.3

См. Также:

DirContext.getAttributes(javax.naming.Name), DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes), DirContext.bind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes), DirContext.rebind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes), DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes), DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]), Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
BasicAttributes() Создает новый экземпляр Атрибутов.
BasicAttributes(boolean ignoreCase) Создает новый экземпляр Атрибутов.
BasicAttributes(String attrID, Object val) Создает новый экземпляр Атрибутов с одним атрибутом.
BasicAttributes(String attrID, Object val, boolean ignoreCase) Создает новый экземпляр Атрибутов с одним атрибутом.

Сводка метода

Модификатор и Тип	Метод и Описание
Объект	clone() Создает и возвращает копию этого объекта.
boolean	equals(Object obj) Определяет, равен ли этот BasicAttributes другому Attributes, Два Attributes равен, если они - оба экземпляры Attributes, обрабатывают случай ID атрибута тот же самый путь, и содержат те же самые атрибуты.
Атрибут	get(String attrID) Получает атрибут с данным идентификатором атрибута от набора атрибута.
NamingEnumeration<Attribute>	getAll() Получает перечисление атрибутов в наборе атрибута.
NamingEnumeration<String>	getIDs() Получает перечисление идентификаторов атрибутов в наборе атрибута.
int	hashCode() Вычисляет хэш-код этого BasicAttributes.
boolean	isCaseIgnored() Определяет, игнорирует ли набор атрибута регистр идентификаторов атрибута, получая или добавляя атрибуты.
Атрибут	put(Attribute attr) Добавляет новый атрибут к набору атрибута.
Атрибут	put(String attrID, Object val) Добавляет новый атрибут к набору атрибута.
Атрибут	remove(String attrID) Удаляет атрибут с идентификатором атрибута 'attrID' от набора атрибута.
int	size() Получает число атрибутов в наборе атрибута.
Строка	toString() Генерирует строковое представление этого набора атрибута.

Методы, наследованные от class java.lang. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

BasicAttributes

public BasicAttributes()

Создает новый экземпляр Атрибутов. Символьный случай идентификаторов атрибута является существенным, впоследствии получая или добавляя атрибуты.

BasicAttributes

public BasicAttributes(boolean ignoreCase)

Создает новый экземпляр Атрибутов. Если ignoreCase истина, символьный регистр идентификаторов атрибута игнорируется; иначе случай является существенным.

Параметры:

ignoreCase - истина означает, что этот набор атрибута будет игнорировать регистр своих идентификаторов атрибута, получая или добавляя атрибуты; ложный случай средств уважают.

BasicAttributes

public BasicAttributes(String attrID,
                       Object val)

Создает новый экземпляр Атрибутов с одним атрибутом. Атрибут, определенный attrID и val, добавляется к недавно создаваемому атрибуту. Символьный случай идентификаторов атрибута является существенным, впоследствии получая или добавляя атрибуты.

Параметры:

attrID - необнулите идентификатор атрибута, чтобы добавить.

val - Значение атрибута, чтобы добавить. Если ноль, нулевое значение добавляется к атрибуту.

BasicAttributes

public BasicAttributes(String attrID,
                       Object val,
                       boolean ignoreCase)

Создает новый экземпляр Атрибутов с одним атрибутом. Атрибут, определенный attrID и val, добавляется к недавно создаваемому атрибуту. Если ignoreCase истина, символьный регистр идентификаторов атрибута игнорируется; иначе случай является существенным.

Параметры:

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

val - Значение атрибута, чтобы добавить. Если ноль, нулевое значение добавляется к атрибуту.

ignoreCase - истина означает, что этот набор атрибута будет игнорировать регистр своих идентификаторов атрибута, получая или добавляя атрибуты; ложный случай средств уважают.

Деталь метода

клон

public Object clone()

Описание скопировало с class: Object

Создает и возвращает копию этого объекта. Точное значение "копии" может зависеть от class объекта. Общее намерение состоит в том что для любого объекта x, выражение:

 x.clone() != x

будет истина, и что выражение:

 x.clone().getClass() == x.getClass()

будет true, но они не абсолютные требования. В то время как это обычно имеет место что:

 x.clone().equals(x)

будет true, это не абсолютное требование.

Условно, возвращенный объект должен быть получен, вызывая super.clone. Если class и все его суперклассы (кроме Object) повинуйтесь этому соглашению, оно будет иметь место это x.clone().getClass() == x.getClass().

Условно, объект, возвращенный этим методом, должен быть независимым от этого объекта (который клонируется). Чтобы достигнуть этой независимости, может быть необходимо изменить одно или более полей объекта, возвращенного super.clone прежде, чем возвратить это. Как правило, это означает копировать любые изменчивые объекты, которые включают внутреннюю "глубинную структуру" клонируемого объекта и заменяющий ссылки на эти объекты со ссылками на копии. Если class содержит только примитивные поля или ссылки на неизменные объекты, то он обычно имеет место что никакие поля в объекте, возвращенном super.clone потребность, которая будет изменена.

Метод clone для class Object выполняет определенную работу клонирования. Во-первых, если class этого объекта не реализует интерфейс Cloneable, тогда a CloneNotSupportedException бросается. Отметьте, что все массивы, как полагают, реализуют интерфейс Cloneable и что тип возврата clone метод типа массива T[] T[] где T является любым ссылочным типом или типом примитива. Иначе, этот метод создает новый экземпляр class этого объекта и инициализирует все его поля с точно содержанием соответствующих полей этого объекта, как будто присвоением; содержание полей самостоятельно не клонируется. Таким образом этот метод выполняет "мелкую копию" этого объекта, не "глубокой копии" работа.

class Object самостоятельно не реализует интерфейс Cloneable, так вызов clone метод на объекте, class которого Object приведет к выдаче исключения во время выполнения.

Определенный:

clone в интерфейсе Attributes

Переопределения:

clone в class Object

Возвраты:

клон этого экземпляра.

См. Также:

Cloneable

isCaseIgnored

public boolean isCaseIgnored()

Описание скопировало с интерфейса: Attributes

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

Определенный:

isCaseIgnored в интерфейсе Attributes

Возвраты:

истина, если регистр игнорируется; ложь иначе.

размер

public int size()

Описание скопировало с интерфейса: Attributes

Получает число атрибутов в наборе атрибута.

Определенный:

size в интерфейсе Attributes

Возвраты:

Неотрицательный номер атрибутов в этом атрибуте определяется.

добраться

public Attribute get(String attrID)

Описание скопировало с интерфейса: Attributes

Получает атрибут с данным идентификатором атрибута от набора атрибута.

Определенный:

get в интерфейсе Attributes

Параметры:

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

Возвраты:

Атрибут идентифицируется attrID; нуль, если не найденный.

См. Также:

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

getAll

public NamingEnumeration<Attribute> getAll()

Описание скопировало с интерфейса: Attributes

Получает перечисление атрибутов в наборе атрибута. Эффекты обновлений к этому набору атрибута на этом перечислении неопределены.

Определенный:

getAll в интерфейсе Attributes

Возвраты:

Устанавливается ненулевое перечисление атрибутов в этом атрибуте. Каждый элемент перечисления имеет class Attribute. Если у набора атрибута есть нулевые атрибуты, пустое перечисление возвращается.

getIDs

public NamingEnumeration<String> getIDs()

Описание скопировало с интерфейса: Attributes

Получает перечисление идентификаторов атрибутов в наборе атрибута. Эффекты обновлений к этому набору атрибута на этом перечислении неопределены.

Определенный:

getIDs в интерфейсе Attributes

Возвраты:

Устанавливается ненулевое перечисление идентификаторов атрибутов в этом атрибуте. Каждый элемент перечисления имеет Строку class. Если у набора атрибута есть нулевые атрибуты, пустое перечисление возвращается.

поместить

public Attribute put(String attrID,
                     Object val)

Описание скопировало с интерфейса: Attributes

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

Определенный:

put в интерфейсе Attributes

Параметры:

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

val - Возможно нулевое значение атрибута, чтобы добавить. Если ноль, у атрибута нет никаких значений.

Возвраты:

Атрибут с attrID, который был предыдущим в этом наборе атрибута; нуль, если никакой такой атрибут не существовал.

См. Также:

Attributes.remove(java.lang.String)

поместить

public Attribute put(Attribute attr)

Описание скопировало с интерфейса: Attributes

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

Определенный:

put в интерфейсе Attributes

Параметры:

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

Возвраты:

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

См. Также:

Attributes.remove(java.lang.String)

удалить

public Attribute remove(String attrID)

Описание скопировало с интерфейса: Attributes

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

Определенный:

remove в интерфейсе Attributes

Параметры:

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

Возвраты:

Атрибут с тем же самым ID как attrID, который был предыдущим в наборе атрибута; нуль, если никакой такой атрибут не существовал.

toString

public String toString()

Генерирует строковое представление этого набора атрибута. Строка состоит из каждого идентификатора атрибута и содержания каждого атрибута. Содержание этой строки полезно для отладки и не предназначается, чтобы быть интерпретированным программно.

Переопределения:

toString в class Object

Возвраты:

Непустая строка, перечисляющая содержание этого атрибута, устанавливается.

равняется

public boolean equals(Object obj)

Определяет, равен ли этот BasicAttributes другому Attributes, Два Attributes равен, если они - оба экземпляры Attributes, обрабатывают случай ID атрибута тот же самый путь, и содержат те же самые атрибуты. Каждый Attribute в этом BasicAttributes проверяется на равенство, используя Object.equals(), который может иметь быть переопределенным реализациями Attribute). Если подкласс переопределяет equals(), он должен переопределить hashCode() также так, чтобы у двух экземпляров Attributes, которые равны, был тот же самый хэш-код.

Переопределения:

equals в class Object

Параметры:

obj - возможно нуль возражают, чтобы сравниться с.

Возвраты:

истина, Если obj равен этому BasicAttributes.

См. Также:

hashCode()

хэш-код

public int hashCode()

Вычисляет хэш-код этого BasicAttributes.

Хэш-код вычисляется, добавляя хэш-код атрибутов этого объекта. Если этот BasicAttributes игнорирует регистр своих ID атрибута, каждый добавляется к хэш-коду. Если подкласс переопределяет hashCode(), он должен переопределить equals() также так, чтобы у двух экземпляров Attributes, которые равны, был тот же самый хэш-код.

Переопределения:

hashCode в class Object

Возвраты:

интервал, представляющий хэш-код этого экземпляра BasicAttributes.

См. Также:

equals(java.lang.Object)