Класс AttributeList

public class AttributeList
extends ArrayList<Object>

Представляет список значений для атрибутов MBean. См. методы getAttributes и setAttributes класса MBeanServer и MBeanServerConnection.

По соображениям совместимости, хотя и крайне не рекомендуется, можно добавлять в AttributeList объекты, которые не являются экземплярами Attribute. Однако AttributeList может быть сделано безопасным, что означает, что попытка добавить объект, который не является Attribute, приведет к IllegalArgumentException. AttributeList становится безопасным, когда вызывается метод asList().

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

AttributeList

public AttributeList()

Создаёт пустой AttributeList.

AttributeList

public AttributeList(int initialCapacity)

Создаёт пустой AttributeList с указанной начальной ёмкостью.

Параметры:

initialCapacity - начальная ёмкость AttributeList, как указано в ArrayList(int).

AttributeList

public AttributeList(AttributeList list)

Создаёт AttributeList, содержащий элементы указанного AttributeList, в порядке, в котором они возвращаются итератором AttributeList. Объект AttributeList имеет начальную ёмкость, равную 110% от размера указанного AttributeList.

Параметры:

list - AttributeList, определяющий начальное содержимое нового AttributeList.

См. также:

ArrayList(java.util.Collection)

AttributeList

public AttributeList(List<Attribute> list)

Создаёт AttributeList, содержащий элементы указанного List, в порядке, в котором они возвращаются итератором List.

Параметры:

list - List, определяющий начальное содержимое нового AttributeList.

Исключения:

IllegalArgumentException - если параметр list является null или если параметр list содержит объекты, отличные от Attribute.

С:

1.6

См. также:

ArrayList(java.util.Collection)

Методы

asList

public List<Attribute> asList()

Возвращает представление этого списка в виде List<Attribute>. Изменения возвращаемого значения отражаются в исходном AttributeList и наоборот.

Возвращает:

List<Attribute> с содержимым, отражающим содержимое этого AttributeList.

Если этот метод когда-либо вызывался для данного экземпляра AttributeList, последующая попытка добавить объект, который не является Attribute, завершится исключением IllegalArgumentException. По соображениям совместимости AttributeList позволяет добавлять объекты, отличные от Attribute.

Исключения:

IllegalArgumentException - если этот AttributeList содержит элемент, который не является Attribute.

С:

1.6

add

public void add(Attribute object)

Добавляет указанный Attribute в качестве последнего элемента списка.

Параметры:

object - добавляемый атрибут.

add

public void add(int index,
                Attribute object)

Вставляет указанный атрибут в указанную позицию. Элементы с индексом, большим или равным текущей позиции, смещаются вверх. Если индекс находится вне допустимого диапазона (индекс < 0 || индекс > размер()), должно быть возбуждено исключение RuntimeOperationsException, которое обернёт возбуждённое исключение java.lang.IndexOutOfBoundsException.

Параметры:

object - объект Attribute для вставки.

index - позиция в списке, куда следует вставить новый объект Attribute.

set

public void set(int index,
                Attribute object)

Заменяет элемент в указанной позиции на указанный атрибут. Предыдущий элемент в этой позиции отбрасывается. Если индекс находится вне допустимого диапазона (индекс < 0 || индекс > размер()), должно быть возбуждено исключение RuntimeOperationsException, которое обернёт возбуждённое исключение java.lang.IndexOutOfBoundsException.

Параметры:

object - значение, на которое должен быть установлен атрибут.

index - указанная позиция.

addAll

public boolean addAll(AttributeList list)

Добавляет все элементы указанного AttributeList в конец списка в порядке, определённом итератором указанного AttributeList.

Параметры:

list - элементы для вставки в список.

Возвращает:

true, если список был изменён в результате вызова.

См. также:

ArrayList.addAll(java.util.Collection)

addAll

public boolean addAll(int index,
                      AttributeList list)

Вставляет все элементы указанного AttributeList в этот список, начиная с указанной позиции, в порядке, определённом итератором указанного AttributeList.

Параметры:

list - элементы для вставки в список.

index - позиция, с которой следует начать вставку элементов из указанного AttributeList.

Возвращает:

true, если список был изменён в результате вызова.

См. также:

ArrayList.addAll(int, java.util.Collection)

add

public boolean add(Object element)

Добавляет указанный элемент в конец этого списка.

Определено в:

add в интерфейсе Collection<Object>

Определено в:

add в интерфейсе List<Object>

Переопределяет:

add в классе ArrayList<Object>

Параметры:

element - элемент для добавления в конец списка

Возвращает:

true (как определено в Collection.add(E))

Исключения:

IllegalArgumentException - если этот AttributeList является типобезопасным и element не является Attribute.

add

public void add(int index,
                Object element)

Вставляет указанный элемент в указанную позицию в этом списке. Смещает элемент, находящийся в этой позиции (если таковой имеется), и все последующие элементы вправо (увеличивает их индексы).

Определено в:

add в интерфейсе List<Object>

Переопределяет:

add в классе ArrayList<Object>

Параметры:

index - индекс, в который должен быть вставлен указанный элемент

element - вставляемый элемент

Исключения:

IllegalArgumentException - если этот AttributeList является типобезопасным и element не является Attribute.

addAll

public boolean addAll(Collection<?> c)

Добавляет все элементы указанного набора в конец этого списка в порядке, в котором они возвращаются итератором указанного набора. Поведение этой операции не определено, если указанный набор изменяется во время выполнения операции. (Это подразумевает, что поведение этого вызова не определено, если указанный набор — это этот список, и этот список не пуст.)

Определено в:

addAll в интерфейсе Collection<Object>

Определено в:

addAll в интерфейсе List<Object>

Переопределяет:

addAll в классе ArrayList<Object>

Параметры:

c - набор, содержащий элементы, которые необходимо добавить в этот список

Возвращает:

true если этот список был изменён в результате вызова

Исключения:

IllegalArgumentException - если этот AttributeList является типобезопасным и c содержит элемент, который не является Attribute.

См. также:

AbstractCollection.add(Object)

addAll

public boolean addAll(int index,
                      Collection<?> c)

Вставляет все элементы указанного набора в этот список, начиная с указанной позиции. Смещает элемент, находящийся в этой позиции (если таковой имеется), и все последующие элементы вправо (увеличивает их индексы). Новые элементы появятся в списке в порядке, в котором они возвращаются итератором указанного набора.

Определено в:

addAll в интерфейсе List<Object>

Переопределяет:

addAll в классе ArrayList<Object>

Параметры:

index - индекс, с которого следует начать вставку элементов из указанного набора

c - набор, содержащий элементы, которые необходимо добавить в этот список

Возвращает:

true если этот список был изменён в результате вызова

Исключения:

IllegalArgumentException - если этот AttributeList является типобезопасным и c содержит элемент, который не является Attribute.

set

public Object set(int index,
                  Object element)

Заменяет элемент в указанной позиции в этом списке указанным элементом.

Определено в:

set в интерфейсе List<Object>

Переопределяет:

set в классе ArrayList<Object>

Параметры:

index - индекс заменяемого элемента

element - элемент, который следует сохранить в указанной позиции

Возвращает:

элемент, который находился ранее в указанной позиции

Исключения:

IllegalArgumentException - если этот AttributeList является типобезопасным и element не является Attribute.