BasicAttribute (Платформа Java SE 7)

java.lang. Объект
- javax.naming.directory. BasicAttribute

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

Сериализуемый, Cloneable, Атрибут
```
public class BasicAttribute
extends Object
implements Attribute
```
Этот класс обеспечивает основную реализацию интерфейса Attribute.
Эта реализация не поддерживает методы getAttributeDefinition() и getAttributeSyntaxDefinition() схемы. Они просто бросают OperationNotSupportedException. Подклассы BasicAttribute должны переопределить эти методы, если они поддерживают их.
Класс BasicAttribute использованием по умолчанию Object.equals(), чтобы определить равенство значений атрибута, тестируя на равенство или ища значения, кроме тех случаев, когда значение является массивом. Для массива каждый элемент массива проверяется, используя Object.equals(). Подклассы BasicAttribute могут использовать информацию о схеме, когда выполнение подобного равенства проверяет методы переопределения, в которых такое использование схемы значимо. Точно так же класс BasicAttribute значением по умолчанию возвращает значения, которые передают его конструктору и/или использованию, которым управляют, добавить/удалить методы. Подклассы BasicAttribute могут переопределить get() и getAll(), чтобы получить значения динамически из каталога (или реализовать интерфейс Attribute непосредственно вместо того, чтобы разделить на подклассы BasicAttribute).
Отметьте, что обновления к BasicAttribute (такие как добавление или удаление значения) не влияют на соответствующее представление атрибута в каталоге. Обновления к каталогу могут только быть произведены, используя операции в интерфейсе DirContext.
Экземпляр BasicAttribute не синхронизируется против параллельного многопоточного доступа. Многократные потоки, пытающиеся получить доступ и изменить BasicAttribute, должны заблокировать объект.

С тех пор:

1.3

См. Также:
Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected String`	`attrID` Содержит идентификатор атрибута.
`protected boolean`	`упорядоченный` Флаг для того, чтобы записать, упорядочиваются ли значения этого атрибута.
`protected Vector<Object>`	`значения` Содержит значения атрибута.

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

Конструкторы
Конструктор и Описание
`BasicAttribute(String id)` Создает новый экземпляр неупорядоченного атрибута без значения.
`BasicAttribute(String id, boolean ordered)` Создает новый экземпляр возможно упорядоченного атрибута без значения.
`BasicAttribute(String id, Object value)` Создает новый экземпляр неупорядоченного атрибута с единственным значением.
`BasicAttribute(String id, Object value, boolean ordered)` Создает новый экземпляр возможно упорядоченного атрибута с единственным значением.

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`add(int ix, Object attrVal)` Добавляет значение атрибута к упорядоченному списку значений атрибута.
`boolean`	`add(Object attrVal)` Добавляет новое значение к этому атрибуту.
`void`	`clear()` Удаляет все значения из этого атрибута.
`Объект`	`clone()` Создает и возвращает копию этого объекта.
`boolean`	`contains(Object attrVal)` Определяет, является ли значение в этом атрибуте.
`boolean`	`equals(Object obj)` Определяет, равен ли obj этому атрибуту.
`Объект`	`get()` Получает одно из значений этого атрибута.
`Объект`	`get(int ix)` Получает значение атрибута от упорядоченного списка значений атрибута.
`NamingEnumeration<?>`	`getAll()` Получает перечисление значений этого атрибута.
`DirContext`	`getAttributeDefinition()` Получает определение схемы этого атрибута.
`DirContext`	`getAttributeSyntaxDefinition()` Получает определение синтаксиса, связанное с этим атрибутом.
`Строка`	`getID()` Получает идентификатор этого атрибута.
`int`	`hashCode()` Вычисляет хэш-код этого атрибута.
`boolean`	`isOrdered()` Определяет, упорядочиваются ли значения этого атрибута.
`Объект`	`remove(int ix)` Удаляет значение атрибута из упорядоченного списка значений атрибута.
`boolean`	`remove(Object attrval)` Удаляет указанное значение из этого атрибута.
`Объект`	`set(int ix, Object attrVal)` Устанавливает значение атрибута в упорядоченном списке значений атрибута.
`int`	`size()` Получает число значений в этом атрибуте.
`Строка`	`toString()` Генерирует строковое представление этого атрибута.

Методы java.lang унаследованный от класса. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - attrID
```
protected String attrID
```
    Содержит идентификатор атрибута. Это инициализируется общедоступным конструктором и не может быть нулем, если методы в BasicAttribute, которые используют attrID, не были переопределены.
  - значения
```
protected transient Vector<Object> values
```
    Содержит значения атрибута. Инициализированный общедоступными конструкторами. Не может быть нуль, если методы в BasicAttribute, которые используют значения, не были переопределены.
  - упорядоченный
```
protected boolean ordered
```
    Флаг для того, чтобы записать, упорядочиваются ли значения этого атрибута.
- Деталь конструктора
  - BasicAttribute
```
public BasicAttribute(String id)
```
    Создает новый экземпляр неупорядоченного атрибута без значения.
    
    Параметры:
    id - Идентификатор атрибута. Это не может быть нуль.
  - BasicAttribute
```
public BasicAttribute(String id,
              Object value)
```
    Создает новый экземпляр неупорядоченного атрибута с единственным значением.
    
    Параметры:
    id - Идентификатор атрибута. Это не может быть нуль.
    value - Значение атрибута. Если ноль, нулевое значение добавляется к атрибуту.
  - BasicAttribute
```
public BasicAttribute(String id,
              boolean ordered)
```
    Создает новый экземпляр возможно упорядоченного атрибута без значения.
    
    Параметры:
    id - Идентификатор атрибута. Это не может быть нуль.
    ordered - истина означает, что значения атрибута будут упорядочены; ложь иначе.
  - BasicAttribute
```
public BasicAttribute(String id,
              Object value,
              boolean ordered)
```
    Создает новый экземпляр возможно упорядоченного атрибута с единственным значением.
    
    Параметры:
    id - Идентификатор атрибута. Это не может быть нуль.
    value - Значение атрибута. Если ноль, нулевое значение добавляется к атрибуту.
    ordered - истина означает, что значения атрибута будут упорядочены; ложь иначе.
- Деталь метода
  - клон
```
public Object clone()
```
    Описание скопировало с класса: Object
    Создает и возвращает копию этого объекта. Точное значение "копии" может зависеть от класса объекта. Общее намерение состоит в том что для любого объекта x, выражение:
    x.clone() != x
    будет истина, и что выражение:
    x.clone().getClass() == x.getClass()
    будет true, но они не абсолютные требования. В то время как это обычно имеет место что:
    x.clone().equals(x)
    будет true, это не абсолютное требование.
    Условно, возвращенный объект должен быть получен, вызывая super.clone. Если класс и все его суперклассы (кроме Object) повинуйтесь этому соглашению, оно будет иметь место это x.clone().getClass() == x.getClass().
    Условно, объект, возвращенный этим методом, должен быть независимым от этого объекта (который клонируется). Чтобы достигнуть этой независимости, может быть необходимо изменить одно или более полей объекта, возвращенного super.clone прежде, чем возвратить это. Как правило, это означает копировать любые изменчивые объекты, которые включают внутреннюю "глубинную структуру" клонируемого объекта и заменяющий ссылки на эти объекты со ссылками на копии. Если класс содержит только примитивные поля или ссылки на неизменные объекты, то он обычно имеет место что никакие поля в объекте, возвращенном super.clone потребность, которая будет изменена.
    Метод clone для класса Object выполняет определенную работу клонирования. Во-первых, если класс этого объекта не реализует интерфейс Cloneable, тогда a CloneNotSupportedException бросается. Отметьте, что все массивы, как полагают, реализуют интерфейс Cloneable и что тип возврата clone метод типа массива T[] T[] где T является любым ссылочным типом или типом примитива. Иначе, этот метод создает новый экземпляр класса этого объекта и инициализирует все его поля с точно содержанием соответствующих полей этого объекта, как будто присвоением; содержание полей самостоятельно не клонируется. Таким образом этот метод выполняет "мелкую копию" этого объекта, не "глубокой копии" работа.
    Класс Object самостоятельно не реализует интерфейс Cloneable, так вызов clone метод на объекте, класс которого Object приведет к выдаче исключения во время выполнения.
    Определенный:
    
    clone в интерфейсе Attribute
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    клон этого экземпляра.
    См. Также:
    Cloneable
  - равняется
```
public boolean equals(Object obj)
```
    Определяет, равен ли obj этому атрибуту. Два атрибута равны, если их идентификаторы атрибута, синтаксисы и значения равны. Если значения атрибута неупорядочиваются, порядок, что значения были добавлены, не важен. Если значения атрибута упорядочиваются, то порядок значения должен соответствовать. Если obj является нулем или не Атрибутом, false возвращается.
    Object.equals() по умолчанию используется, сравнивая идентификатор атрибута и его значения кроме тех случаев, когда значение является массивом. Для массива каждый элемент массива проверяется, используя Object.equals(). Подкласс может переопределить это, чтобы использовать информацию о синтаксисе схемы и соответствие правил, которые определяют то, что это означает для двух атрибутов быть равным. Как и использует ли подкласс информацию о схеме, определяется подклассом. Если подкласс переопределяет equals(), он должен также переопределить hashCode() так, что два атрибута, которые равны, имеют тот же самый хэш-код.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    obj - Возможно нуль возражают, чтобы проверить.
    
    Возвраты:
    истина, если obj равен этому атрибуту; ложь иначе.
    См. Также:
    hashCode(), contains(java.lang.Object)
  - хэш-код
```
public int hashCode()
```
    Вычисляет хэш-код этого атрибута.
    Хэш-код вычисляется, добавляя хэш-код идентификатора атрибута и то изо всех его значений за исключением значений, которые являются массивами. Для массива суммируется хэш-код каждого элемента массива. Если подкласс переопределяет hashCode(), он должен переопределить equals() также так, чтобы у двух атрибутов, которые равны, был тот же самый хэш-код.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    интервал, представляющий хэш-код этого атрибута.
    См. Также:
    equals(java.lang.Object)
  - toString
```
public String toString()
```
    Генерирует строковое представление этого атрибута. Строка состоит из идентификатора атрибута и его значений. Эта строка предназначается для отладки и не предназначенная, чтобы быть интерпретированной программно.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Представление непустой строки этого атрибута.
  - getAll
```
public NamingEnumeration<?> getAll()
                            throws NamingException
```
    Получает перечисление значений этого атрибута.
    По умолчанию возвращенные значения являются теми, которых передают конструктору и/или использованию, которым управляют, добавить/заменить/удалить методы. Подкласс может переопределить это, чтобы получить значения динамически из каталога.
    
    Определенный:
    
    getAll в интерфейсе Attribute
    
    Возвраты:
    Ненулевое перечисление значений атрибута. Каждым элементом перечисления является возможно нулевой Объект. Класс объекта является классом значения атрибута. Элемент является нулем, если значение атрибута является нулем. Если у атрибута есть нулевые значения, пустое перечисление возвращается.
    
    Броски:
    
    NamingException - Если с исключением именования встретились, получая значения.
    См. Также:
    Attribute.isOrdered()
  - добраться
```
public Object get()
           throws NamingException
```
    Получает одно из значений этого атрибута.
    По умолчанию возвращенное значение является одним из тех, которых передают конструктору и/или использованию, которым управляют, добавить/заменить/удалить методы. Подкласс может переопределить это, чтобы получить значение динамически из каталога.
    
    Определенный:
    
    get в интерфейсе Attribute
    
    Возвраты:
    Возможно нулевой объект, представляющий одно из значения атрибута. Это - нуль, если значение атрибута является нулем.
    
    Броски:
    
    NamingException - Если с исключением именования встретились, получая значение.
  - размер
```
public int size()
```
    Описание скопировало с интерфейса: Attribute
    
    Получает число значений в этом атрибуте.
    
    Определенный:
    
    size в интерфейсе Attribute
    
    Возвраты:
    Неотрицательное число значений в этом атрибуте.
  - getID
```
public String getID()
```
    Описание скопировало с интерфейса: Attribute
    
    Получает идентификатор этого атрибута.
    
    Определенный:
    
    getID в интерфейсе Attribute
    
    Возвраты:
    Идентификатор этого атрибута. Это не может быть нуль.
  - содержит
```
public boolean contains(Object attrVal)
```
    Определяет, является ли значение в этом атрибуте.
    По умолчанию Object.equals() используется, сравнивая attrVal со значениями этого атрибута кроме тех случаев, когда attrVal является массивом. Для массива каждый элемент массива проверяется, используя Object.equals(). Подкласс может использовать информацию о схеме, чтобы определить равенство.
    
    Определенный:
    
    contains в интерфейсе Attribute
    
    Параметры:
    attrVal - Возможно нулевое значение, чтобы проверить. Если ноль, проверьте, есть ли у атрибута значение атрибута, значение которого является нулем.
    
    Возвраты:
    истина, если attrVal является одним из значений этого атрибута; ложь иначе.
    См. Также:
    Object.equals(java.lang.Object), equals(java.lang.Object)
  - добавить
```
public boolean add(Object attrVal)
```
    Добавляет новое значение к этому атрибуту.
    По умолчанию Object.equals() используется, сравнивая attrVal со значениями этого атрибута кроме тех случаев, когда attrVal является массивом. Для массива каждый элемент массива проверяется, используя Object.equals(). Подкласс может использовать информацию о схеме, чтобы определить равенство.
    
    Определенный:
    
    add в интерфейсе Attribute
    
    Параметры:
    attrVal - Новое возможно нулевое значение, чтобы добавить. Если ноль, нуль добавляется как значение атрибута.
    
    Возвраты:
    истина, если значение было добавлено; ложь иначе.
  - удалить
```
public boolean remove(Object attrval)
```
    Удаляет указанное значение из этого атрибута.
    По умолчанию Object.equals() используется, сравнивая attrVal со значениями этого атрибута кроме тех случаев, когда attrVal является массивом. Для массива каждый элемент массива проверяется, используя Object.equals(). Подкласс может использовать информацию о схеме, чтобы определить равенство.
    
    Определенный:
    
    remove в интерфейсе Attribute
    
    Параметры:
    attrval - Возможно нулевое значение, чтобы удалить из этого атрибута. Если ноль, удалите значение атрибута, которое является нулем.
    
    Возвраты:
    истина, если значение было удалено; ложь иначе.
  - очистить
```
public void clear()
```
    Описание скопировало с интерфейса: Attribute
    
    Удаляет все значения из этого атрибута.
    
    Определенный:
    
    clear в интерфейсе Attribute
  - isOrdered
```
public boolean isOrdered()
```
    Описание скопировало с интерфейса: Attribute
    
    Определяет, упорядочиваются ли значения этого атрибута. Если значения атрибута упорядочиваются, копируют значения, позволяются. Если значения атрибута неупорядочиваются, они представляются в любом порядке и нет никаких двойных значений.
    
    Определенный:
    
    isOrdered в интерфейсе Attribute
    
    Возвраты:
    истина, если значения этого атрибута упорядочиваются; ложь иначе.
    См. Также:
    Attribute.get(int), Attribute.remove(int), Attribute.add(int, java.lang.Object), Attribute.set(int, java.lang.Object)
  - добраться
```
public Object get(int ix)
           throws NamingException
```
    Описание скопировало с интерфейса: Attribute
    
    Получает значение атрибута от упорядоченного списка значений атрибута. Этот метод возвращает значение по индексу ix списка значений атрибута. Если значения атрибута неупорядочиваются, этот метод возвращает значение, которое, оказывается, по тому индексу.
    
    Определенный:
    
    get в интерфейсе Attribute
    
    Параметры:
    ix - Индекс значения в упорядоченном списке значений атрибута. 0 <= ixsize ().
    Возвраты:
    Возможно неопределенный атрибут оценивает в индекс ix; нуль, если значение атрибута является нулем.
    
    Броски:
    
    NamingException - Если с исключением именования встретились, получая значение.
  - удалить
```
public Object remove(int ix)
```
    Описание скопировало с интерфейса: Attribute
    
    Удаляет значение атрибута из упорядоченного списка значений атрибута. Этот метод удаляет значение по индексу ix списка значений атрибута. Если значения атрибута неупорядочиваются, этот метод удаляет значение, которое, оказывается, по тому индексу. Значения, расположенные в индексах, больше чем ix, смещаются к передней стороне списка (и их индексы, постепенно уменьшенные одним).
    
    Определенный:
    
    remove в интерфейсе Attribute
    
    Параметры:
    ix - Индекс значения, чтобы удалить. 0 <= ixsize ().
    Возвраты:
    Возможно неопределенный атрибут оценивает в индекс ix, который был удален; нуль, если значение атрибута является нулем.
  - добавить
```
public void add(int ix,
       Object attrVal)
```
    Описание скопировало с интерфейса: Attribute
    
    Добавляет значение атрибута к упорядоченному списку значений атрибута. Этот метод добавляет attrVal к списку значений атрибута по индексу ix. Значения, расположенные в индексах в или больше чем ix, смещаются вниз к концу списка (и их индексы, постепенно увеличенные одним). Если значения атрибута неупорядочиваются и уже имеют attrVal, IllegalStateException бросается.
    
    Определенный:
    
    add в интерфейсе Attribute
    
    Параметры:
    ix - Индекс в упорядоченном списке значений атрибута, чтобы добавить новое значение. 0 <= ixsize ().
    attrVal - Возможно значение неопределенного атрибута, чтобы добавить; если ноль, нуль является добавленным значением.
  - набор
```
public Object set(int ix,
         Object attrVal)
```
    Описание скопировало с интерфейса: Attribute
    
    Устанавливает значение атрибута в упорядоченном списке значений атрибута. Этот метод устанавливает значение по индексу ix списка значений атрибута, чтобы быть attrVal. Старое значение удаляется. Если значения атрибута неупорядочиваются, этот метод устанавливает значение, которое, оказывается, по тому индексу к attrVal, если attrVal уже не является одним из значений. В этом случае IllegalStateException бросается.
    
    Определенный:
    
    set в интерфейсе Attribute
    
    Параметры:
    ix - Индекс значения в упорядоченном списке значений атрибута. 0 <= ixsize ().
    attrVal - Возможно неопределенный атрибут оценивает использованию. Если ноль, 'нуль' заменяет старое значение.
    
    Возвраты:
    Возможно неопределенный атрибут оценивает в индекс ix, который был заменен. Нуль, если значение атрибута было нулем.
  - getAttributeSyntaxDefinition
```
public DirContext getAttributeSyntaxDefinition()
                                        throws NamingException
```
    Получает определение синтаксиса, связанное с этим атрибутом.
    Этот метод бросками по умолчанию OperationNotSupportedException. Подкласс должен переопределить этот метод, если это поддерживает схему.
    
    Определенный:
    
    getAttributeSyntaxDefinition в интерфейсе Attribute
    
    Возвраты:
    Определение синтаксиса атрибута. У нуля, если реализация поддерживает схемы, но этот определенный атрибут, нет никакой информации о схеме.
    
    Броски:
    
    OperationNotSupportedException - Если получение схемы не поддерживается.
    
    NamingException - Если исключение именования происходит, получая схему.
  - getAttributeDefinition
```
public DirContext getAttributeDefinition()
                                  throws NamingException
```
    Получает определение схемы этого атрибута.
    Этот метод бросками по умолчанию OperationNotSupportedException. Подкласс должен переопределить этот метод, если это поддерживает схему.
    
    Определенный:
    
    getAttributeDefinition в интерфейсе Attribute
    
    Возвраты:
    Определение схемы этого атрибута. У нуля, если реализация поддерживает схемы, но этот определенный атрибут, нет никакой информации о схеме.
    
    Броски:
    
    OperationNotSupportedException - Если получение схемы не поддерживается.
    
    NamingException - Если исключение именования происходит, получая схему.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BasicAttribute

Полевая Сводка

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

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

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

Полевая Деталь

attrID

значения

упорядоченный

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

BasicAttribute

BasicAttribute

BasicAttribute

BasicAttribute

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

клон

равняется

хэш-код

toString

getAll

добраться

размер

getID

содержит

добавить

удалить

очистить

isOrdered

добраться

удалить

добавить

набор

getAttributeSyntaxDefinition

getAttributeDefinition