Класс RoleList

java.lang.Object

java.util.AbstractCollection<Object>

java.util.AbstractList<Object>

java.util.ArrayList<Object>

javax.management.relation.RoleList

Все реализованные интерфейсы:: Serializable, Cloneable, Iterable<Object>, Collection<Object>, List<Object>, RandomAccess, SequencedCollection<Object>

public class RoleList extends ArrayList<Object>

RoleList представляет собой список ролей (объектов Role). Он используется в качестве параметра при создании отношения и при попытке установить несколько ролей в отношении (с помощью метода 'setRoles()'). Он возвращается как часть RoleResult и содержит успешно полученные роли.

Запрещается добавлять в RoleList объекты, не являющиеся экземплярами Role. Это приведёт к IllegalArgumentException при вызове методов этого класса или при использовании listIterator, add или set.

Начиная с версии:

1.5

См. также:

Краткое описание полей

Поля, объявленные в классе AbstractList

modCount

Модификатор и тип	Поле	Описание
`protected int`	`modCount`	Количество структурных изменений этого списка.

Краткое описание конструкторов

Конструктор	Описание
`RoleList()`	Создаёт пустой RoleList.
`RoleList(int initialCapacity)`	Создаёт пустой RoleList с указанной начальной ёмкостью.
`RoleList(List<Role> list)`	Создаёт `RoleList`, содержащий элементы указанного `List` в том порядке, в котором они возвращаются итератором `List`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`add(int index, Object element)`	Вставляет указанный элемент в заданную позицию этого списка.
`void`	`add(int index, Role role)`	Вставляет указанную роль как элемент в заданную позицию.
`boolean`	`add(Object o)`	Добавляет указанный элемент в конец этого списка.
`void`	`add(Role role)`	Добавляет указанную роль в качестве последнего элемента списка.
`boolean`	`addAll(int index, Collection<?> c)`	Вставляет все элементы указанной коллекции в этот список, начиная с заданной позиции.
`boolean`	`addAll(int index, RoleList roleList)`	Вставляет все элементы указанного RoleList в этот список, начиная с заданной позиции, в том порядке, в котором они возвращаются итератором указанного RoleList.
`boolean`	`addAll(Collection<?> c)`	Добавляет все элементы указанной коллекции в конец этого списка в том порядке, в котором они возвращаются итератором указанной коллекции.
`boolean`	`addAll(RoleList roleList)`	Добавляет все элементы указанного RoleList в конец списка в том порядке, в котором они возвращаются итератором указанного RoleList.
`List<Role>`	`asList()`	Возвращает представление этого списка в виде `List<Role>`.
`Object`	`set(int index, Object element)`	Заменяет элемент в указанной позиции этого списка указанным элементом.
`void`	`set(int index, Role role)`	Устанавливает указанную роль в качестве элемента в заданной позиции.

Методы, объявленные в классе ArrayList

addFirst, addLast, clear, clone, contains, ensureCapacity, forEach, get, getFirst, getLast, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeFirst, removeIf, removeLast, removeRange, retainAll, size, spliterator, subList, toArray, toArray, trimToSize

Модификатор и тип	Метод	Описание
`void`	`addFirst(Object element)`	Добавляет элемент в начало этой коллекции (необязательная операция).
`void`	`addLast(Object element)`	Добавляет элемент в конец этой коллекции (необязательная операция).
`void`	`clear()`	Удаляет все элементы из этого списка.
`Object`	`clone()`	Возвращает поверхностную копию этого экземпляра `ArrayList`.
`boolean`	`contains(Object o)`	Возвращает `true`, если этот список содержит указанный элемент.
`void`	`ensureCapacity(int minCapacity)`	При необходимости увеличивает ёмкость этого экземпляра `ArrayList`, чтобы он мог вместить не менее числа элементов, заданного аргументом минимальной ёмкости.
`void`	`forEach(Consumer<? super Object> action)`	Выполняет указанное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.
`Object`	`get(int index)`	Возвращает элемент в указанной позиции этого списка.
`Object`	`getFirst()`	Возвращает первый элемент этой коллекции.
`Object`	`getLast()`	Возвращает последний элемент этой коллекции.
`int`	`indexOf(Object o)`	Возвращает индекс первого вхождения указанного элемента в этом списке или -1, если список не содержит этот элемент.
`boolean`	`isEmpty()`	Возвращает `true`, если этот список не содержит элементов.
`Iterator<Object>`	`iterator()`	Возвращает итератор элементов этого списка в надлежащем порядке.
`int`	`lastIndexOf(Object o)`	Возвращает индекс последнего вхождения указанного элемента в этом списке или -1, если список не содержит этот элемент.
`ListIterator<Object>`	`listIterator()`	Возвращает итератор списка для элементов этого списка (в надлежащем порядке).
`ListIterator<Object>`	`listIterator(int index)`	Возвращает итератор списка для элементов этого списка (в надлежащем порядке), начиная с указанной позиции в списке.
`Object`	`remove(int index)`	Удаляет элемент в указанной позиции этого списка.
`boolean`	`remove(Object o)`	Удаляет из этого списка первое вхождение указанного элемента, если он присутствует.
`boolean`	`removeAll(Collection<?> c)`	Удаляет из этого списка все элементы, содержащиеся в указанной коллекции.
`Object`	`removeFirst()`	Удаляет и возвращает первый элемент этой коллекции (необязательная операция).
`boolean`	`removeIf(Predicate<? super Object> filter)`	Удаляет все элементы этой коллекции, удовлетворяющие заданному предикату (необязательная операция).
`Object`	`removeLast()`	Удаляет и возвращает последний элемент этой коллекции (необязательная операция).
`protected void`	`removeRange(int fromIndex, int toIndex)`	Удаляет из этого списка все элементы, индексы которых находятся в диапазоне от `fromIndex` включительно до `toIndex` исключительно.
`boolean`	`retainAll(Collection<?> c)`	Оставляет в этом списке только элементы, содержащиеся в указанной коллекции.
`int`	`size()`	Возвращает количество элементов в этом списке.
`Spliterator<Object>`	`spliterator()`	Создаёт привязанный с задержкой и fail-fast `Spliterator` для элементов этого списка.
`List<Object>`	`subList(int fromIndex, int toIndex)`	Возвращает представление части этого списка между указанными `fromIndex` включительно и `toIndex` исключительно.
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы этого списка в надлежащем порядке (от первого элемента до последнего).
`<T> T[]`	`toArray(T[] a)`	Возвращает массив, содержащий все элементы этого списка в надлежащем порядке (от первого элемента до последнего); тип элементов возвращаемого массива соответствует типу указанного массива.
`void`	`trimToSize()`	Уменьшает ёмкость этого экземпляра `ArrayList` до текущего размера списка.

Методы, объявленные в классе AbstractList

equals, hashCode

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этим списком на равенство.
`int`	`hashCode()`	Возвращает значение хеш-кода этого списка.

Методы, объявленные в классе AbstractCollection

containsAll, toString

Модификатор и тип	Метод	Описание
`boolean`	`containsAll(Collection<?> c)`	Возвращает `true`, если эта коллекция содержит все элементы указанной коллекции.
`String`	`toString()`	Возвращает строковое представление этой коллекции.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии. Финализация устарела и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе Collection

parallelStream, stream, toArray

Модификатор и тип	Метод	Описание
`default Stream<Object>`	`parallelStream()`	Возвращает, возможно, параллельный `Stream` с этой коллекцией в качестве источника.
`default Stream<Object>`	`stream()`	Возвращает последовательный `Stream` с этой коллекцией в качестве источника.
`default <T> T[]`	`toArray(IntFunction<T[]> generator)`	Возвращает массив, содержащий все элементы этой коллекции; для выделения возвращаемого массива используется предоставленная функция `generator`.

Методы, объявленные в интерфейсе List

containsAll, replaceAll, reversed, sort

Модификатор и тип	Метод	Описание
`boolean`	`containsAll(Collection<?> c)`	Возвращает `true`, если этот список содержит все элементы указанной коллекции.
`default void`	`replaceAll(UnaryOperator<Object> operator)`	Заменяет каждый элемент этого списка результатом применения оператора к этому элементу (необязательная операция).
`default List<Object>`	`reversed()`	Возвращает представление этой коллекции в обратном порядке.
`default void`	`sort(Comparator<? super Object> c)`	Сортирует этот список в соответствии с порядком, задаваемым указанным `Comparator` (необязательная операция).

Подробное описание конструкторов

RoleList

public RoleList()

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

RoleList

public RoleList(int initialCapacity)

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

Параметры:: initialCapacity — начальная ёмкость

RoleList

public RoleList(List<Role> list) throws IllegalArgumentException

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

Параметры:

list — List, задающий начальное содержимое нового RoleList.

Исключения:

IllegalArgumentException — если параметр list равен null или параметр list содержит объекты, не являющиеся Role.

См. также:

Подробное описание методов

asList

public List<Role> asList()

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

Возвращает:: List<Role>, содержимое которого соответствует содержимому этого RoleList.
Исключения:: IllegalArgumentException — если этот RoleList содержит элемент, не являющийся Role.
Начиная с версии:: 1.6

add

public void add(Role role) throws IllegalArgumentException

Добавляет указанную роль в качестве последнего элемента списка.

Параметры:: role — добавляемая роль.
Исключения:: IllegalArgumentException — если роль равна null.

add

public void add(int index, Role role) throws IllegalArgumentException, IndexOutOfBoundsException

Вставляет указанную роль как элемент в заданную позицию. Элементы с индексом, большим или равным текущей позиции, сдвигаются вправо.

Параметры:: index — позиция в списке, в которую следует вставить новый объект Role.; role — вставляемый объект Role.
Исключения:: IllegalArgumentException — если роль равна null.; IndexOutOfBoundsException — при обращении по индексу, выходящему за пределы списка.

set

public void set(int index, Role role) throws IllegalArgumentException, IndexOutOfBoundsException

Устанавливает указанную роль в качестве элемента в заданной позиции. Прежний элемент в этой позиции удаляется.

Параметры:: index — указанная позиция.; role — значение, которому следует присвоить элемент роли.
Исключения:: IllegalArgumentException — если роль равна null.; IndexOutOfBoundsException — при обращении по индексу, выходящему за пределы списка.

addAll

public boolean addAll(RoleList roleList) throws IndexOutOfBoundsException

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

Параметры:

roleList — элементы для вставки в список (может быть null)

Возвращает:

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

Исключения:

IndexOutOfBoundsException — при обращении по индексу, выходящему за пределы списка.

См. также:

addAll

public boolean addAll(int index, RoleList roleList) throws IllegalArgumentException, IndexOutOfBoundsException

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

Параметры:

index — позиция, в которую следует вставить первый элемент указанного RoleList.

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

Возвращает:

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

Исключения:

IllegalArgumentException — если роль равна null.

IndexOutOfBoundsException — при обращении по индексу, выходящему за пределы списка.

См. также:

add

public boolean add(Object o)

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

Определено в:: add в интерфейсе Collection<Object>
Определено в:: add в интерфейсе List<Object>
Переопределяет:: add в классе ArrayList<Object>
Параметры:: o — элемент, добавляемый в конец этого списка
Возвращает:: true (как указано в Collection.add(E))
Исключения:: IllegalArgumentException — если o не является Role.

add

public void add(int index, Object element)

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

Определено в:: add в интерфейсе List<Object>
Переопределяет:: add в классе ArrayList<Object>
Параметры:: index — индекс, в который следует вставить указанный элемент; element — вставляемый элемент
Исключения:: IllegalArgumentException — если element не является Role.

addAll

public boolean addAll(Collection<?> c)

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

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

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

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

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

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

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

Параметры:

c — коллекция, содержащая элементы для добавления в этот список

Возвращает:

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

Исключения:

IllegalArgumentException — если c содержит элемент, не являющийся Role.

См. также:

addAll

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

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

Определено в:: addAll в интерфейсе List<Object>
Переопределяет:: addAll в классе ArrayList<Object>
Параметры:: index — индекс, в который следует вставить первый элемент указанной коллекции; c — коллекция, содержащая элементы для добавления в этот список
Возвращает:: true, если в результате вызова этот список изменился
Исключения:: IllegalArgumentException — если c содержит элемент, не являющийся Role.

set

public Object set(int index, Object element)

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

Определено в:: set в интерфейсе List<Object>
Переопределяет:: set в классе ArrayList<Object>
Параметры:: index — индекс заменяемого элемента; element — элемент, сохраняемый в указанной позиции
Возвращает:: элемент, ранее находившийся в указанной позиции
Исключения:: IllegalArgumentException — если element не является Role.

© 1993, 2025, 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.