Summary: Inherited Fields | Ctors | Methods | Inherited Methods | [Expand All]

public class

RoleList

extends ArrayList<E>

java.lang.Object
↳	java.util.AbstractCollection<E>
	↳	java.util.AbstractList<E>
		↳	java.util.ArrayList<E>
			↳	javax.management.relation.RoleList

Class Overview

A RoleList represents a list of roles (Role objects). It is used as parameter when creating a relation, and when trying to set several roles in a relation (via 'setRoles()' method). It is returned as part of a RoleResult, to provide roles successfully retrieved.

Summary

[Expand]

Inherited Fields

From class java.util.AbstractList

Public Constructors
	RoleList() Constructs an empty RoleList.
	RoleList(int initialCapacity) Constructs an empty RoleList with the initial capacity specified.
	RoleList(List<Role> list) Constructs a `RoleList` containing the elements of the `List` specified, in the order in which they are returned by the `List`'s iterator.

Public Methods
void	add(int index, Role role) Inserts the role specified as an element at the position specified.
void	add(int index, Object element) Inserts the specified element at the specified position in this list.
void	add(Role role) Adds the Role specified as the last element of the list.
boolean	add(Object o) Appends the specified element to the end of this list.
boolean	addAll(int index, Collection<?> c) Inserts all of the elements in the specified collection into this list, starting at the specified position.
boolean	addAll(int index, RoleList roleList) Inserts all of the elements in the RoleList specified into this list, starting at the specified position, in the order in which they are returned by the Iterator of the RoleList specified.
boolean	addAll(RoleList roleList) Appends all the elements in the RoleList specified to the end of the list, in the order in which they are returned by the Iterator of the RoleList specified.
boolean	addAll(Collection<?> c) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator.
List<Role>	asList() Return a view of this list as a `List<Role>`.
void	set(int index, Role role) Sets the element at the position specified to be the role specified.
Object	set(int index, Object element) Replaces the element at the specified position in this list with the specified element.

[Expand]

Inherited Methods

From class java.util.ArrayList

boolean	add(E e) Appends the specified element to the end of this list.
void	add(int index, E element) Inserts the specified element at the specified position in this list.
boolean	addAll(Collection<? extends E> c) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator.
boolean	addAll(int index, Collection<? extends E> c) Inserts all of the elements in the specified collection into this list, starting at the specified position.
void	clear() Removes all of the elements from this list.
Object	clone() Returns a shallow copy of this `ArrayList` instance.
boolean	contains(Object o) Returns `true` if this list contains the specified element.
void	ensureCapacity(int minCapacity) Increases the capacity of this `ArrayList` instance, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.
E	get(int index) Returns the element at the specified position in this list.
int	indexOf(Object o) Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
boolean	isEmpty() Returns `true` if this list contains no elements.
Iterator<E>	iterator() Returns an iterator over the elements in this list in proper sequence.
int	lastIndexOf(Object o) Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
ListIterator<E>	listIterator(int index) Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position in the list.
ListIterator<E>	listIterator() Returns a list iterator over the elements in this list (in proper sequence).
E	remove(int index) Removes the element at the specified position in this list.
boolean	remove(Object o) Removes the first occurrence of the specified element from this list, if it is present.
boolean	removeAll(Collection<?> c) Removes from this list all of its elements that are contained in the specified collection.
void	removeRange(int fromIndex, int toIndex) Removes from this list all of the elements whose index is between `fromIndex`, inclusive, and `toIndex`, exclusive.
boolean	retainAll(Collection<?> c) Retains only the elements in this list that are contained in the specified collection.
E	set(int index, E element) Replaces the element at the specified position in this list with the specified element.
int	size() Returns the number of elements in this list.
List<E>	subList(int fromIndex, int toIndex) Returns a view of the portion of this list between the specified `fromIndex`, inclusive, and `toIndex`, exclusive.
<T> T[]	toArray(T[] a) Returns an array containing all of the elements in this list in proper sequence (from first to last element); the runtime type of the returned array is that of the specified array.
Object[]	toArray() Returns an array containing all of the elements in this list in proper sequence (from first to last element).
void	trimToSize() Trims the capacity of this `ArrayList` instance to be the list's current size.

From class java.util.AbstractList

boolean	add(E e) Appends the specified element to the end of this list (optional operation).
void	add(int index, E element) Inserts the specified element at the specified position in this list (optional operation). This implementation always throws an `UnsupportedOperationException`.
boolean	addAll(int index, Collection<? extends E> c) Inserts all of the elements in the specified collection into this list at the specified position (optional operation). This implementation gets an iterator over the specified collection and iterates over it, inserting the elements obtained from the iterator into this list at the appropriate position, one at a time, using `add(int, E)`.
void	clear() Removes all of the elements from this list (optional operation).
boolean	equals(Object o) Compares the specified object with this list for equality.
abstract E	get(int index) Returns the element at the specified position in this list.
int	hashCode() Returns the hash code value for this list.
int	indexOf(Object o) Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element. This implementation first gets a list iterator (with `listIterator()`).
Iterator<E>	iterator() Returns an iterator over the elements in this list in proper sequence.
int	lastIndexOf(Object o) Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element. This implementation first gets a list iterator that points to the end of the list (with `listIterator(size())`).
ListIterator<E>	listIterator(int index) Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position in the list. This implementation returns a straightforward implementation of the `ListIterator` interface that extends the implementation of the `Iterator` interface returned by the `iterator()` method.
ListIterator<E>	listIterator() Returns a list iterator over the elements in this list (in proper sequence). This implementation returns `listIterator(0)`.
E	remove(int index) Removes the element at the specified position in this list (optional operation). This implementation always throws an `UnsupportedOperationException`.
void	removeRange(int fromIndex, int toIndex) Removes from this list all of the elements whose index is between `fromIndex`, inclusive, and `toIndex`, exclusive.
E	set(int index, E element) Replaces the element at the specified position in this list with the specified element (optional operation). This implementation always throws an `UnsupportedOperationException`.
List<E>	subList(int fromIndex, int toIndex) Returns a view of the portion of this list between the specified `fromIndex`, inclusive, and `toIndex`, exclusive. This implementation returns a list that subclasses `AbstractList`.

From class java.util.AbstractCollection

boolean	add(E e) Ensures that this collection contains the specified element (optional operation). This implementation always throws an `UnsupportedOperationException`.
boolean	addAll(Collection<? extends E> c) Adds all of the elements in the specified collection to this collection (optional operation). This implementation iterates over the specified collection, and adds each object returned by the iterator to this collection, in turn.
void	clear() Removes all of the elements from this collection (optional operation). This implementation iterates over this collection, removing each element using the `Iterator.remove` operation.
boolean	contains(Object o) Returns `true` if this collection contains the specified element. This implementation iterates over the elements in the collection, checking each element in turn for equality with the specified element.
boolean	containsAll(Collection<?> c) Returns `true` if this collection contains all of the elements in the specified collection. This implementation iterates over the specified collection, checking each element returned by the iterator in turn to see if it's contained in this collection.
boolean	isEmpty() Returns `true` if this collection contains no elements. This implementation returns `size() == 0`.
abstract Iterator<E>	iterator() Returns an iterator over the elements contained in this collection.
boolean	remove(Object o) Removes a single instance of the specified element from this collection, if it is present (optional operation). This implementation iterates over the collection looking for the specified element.
boolean	removeAll(Collection<?> c) Removes all of this collection's elements that are also contained in the specified collection (optional operation). This implementation iterates over this collection, checking each element returned by the iterator in turn to see if it's contained in the specified collection.
boolean	retainAll(Collection<?> c) Retains only the elements in this collection that are contained in the specified collection (optional operation). This implementation iterates over this collection, checking each element returned by the iterator in turn to see if it's contained in the specified collection.
abstract int	size() Returns the number of elements in this collection.
<T> T[]	toArray(T[] a) Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array. This implementation returns an array containing all the elements returned by this collection's iterator in the same order, stored in consecutive elements of the array, starting with index `0`.
Object[]	toArray() Returns an array containing all of the elements in this collection. This implementation returns an array containing all the elements returned by this collection's iterator, in the same order, stored in consecutive elements of the array, starting with index `0`.
String	toString() Returns a string representation of this collection.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface java.lang.Iterable

From interface java.util.Collection

abstract boolean	add(E e) Ensures that this collection contains the specified element (optional operation).
abstract boolean	addAll(Collection<? extends E> c) Adds all of the elements in the specified collection to this collection (optional operation).
abstract void	clear() Removes all of the elements from this collection (optional operation).
abstract boolean	contains(Object o) Returns `true` if this collection contains the specified element.
abstract boolean	containsAll(Collection<?> c) Returns `true` if this collection contains all of the elements in the specified collection.
abstract boolean	equals(Object o) Compares the specified object with this collection for equality.
abstract int	hashCode() Returns the hash code value for this collection.
abstract boolean	isEmpty() Returns `true` if this collection contains no elements.
abstract Iterator<E>	iterator() Returns an iterator over the elements in this collection.
abstract boolean	remove(Object o) Removes a single instance of the specified element from this collection, if it is present (optional operation).
abstract boolean	removeAll(Collection<?> c) Removes all of this collection's elements that are also contained in the specified collection (optional operation).
abstract boolean	retainAll(Collection<?> c) Retains only the elements in this collection that are contained in the specified collection (optional operation).
abstract int	size() Returns the number of elements in this collection.
abstract <T> T[]	toArray(T[] a) Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.
abstract Object[]	toArray() Returns an array containing all of the elements in this collection.

From interface java.util.List

abstract boolean	add(E e) Appends the specified element to the end of this list (optional operation).
abstract void	add(int index, E element) Inserts the specified element at the specified position in this list (optional operation).
abstract boolean	addAll(Collection<? extends E> c) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's iterator (optional operation).
abstract boolean	addAll(int index, Collection<? extends E> c) Inserts all of the elements in the specified collection into this list at the specified position (optional operation).
abstract void	clear() Removes all of the elements from this list (optional operation).
abstract boolean	contains(Object o) Returns `true` if this list contains the specified element.
abstract boolean	containsAll(Collection<?> c) Returns `true` if this list contains all of the elements of the specified collection.
abstract boolean	equals(Object o) Compares the specified object with this list for equality.
abstract E	get(int index) Returns the element at the specified position in this list.
abstract int	hashCode() Returns the hash code value for this list.
abstract int	indexOf(Object o) Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
abstract boolean	isEmpty() Returns `true` if this list contains no elements.
abstract Iterator<E>	iterator() Returns an iterator over the elements in this list in proper sequence.
abstract int	lastIndexOf(Object o) Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
abstract ListIterator<E>	listIterator(int index) Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position in the list.
abstract ListIterator<E>	listIterator() Returns a list iterator over the elements in this list (in proper sequence).
abstract E	remove(int index) Removes the element at the specified position in this list (optional operation).
abstract boolean	remove(Object o) Removes the first occurrence of the specified element from this list, if it is present (optional operation).
abstract boolean	removeAll(Collection<?> c) Removes from this list all of its elements that are contained in the specified collection (optional operation).
abstract boolean	retainAll(Collection<?> c) Retains only the elements in this list that are contained in the specified collection (optional operation).
abstract E	set(int index, E element) Replaces the element at the specified position in this list with the specified element (optional operation).
abstract int	size() Returns the number of elements in this list.
abstract List<E>	subList(int fromIndex, int toIndex) Returns a view of the portion of this list between the specified `fromIndex`, inclusive, and `toIndex`, exclusive.
abstract <T> T[]	toArray(T[] a) Returns an array containing all of the elements in this list in proper sequence (from first to last element); the runtime type of the returned array is that of the specified array.
abstract Object[]	toArray() Returns an array containing all of the elements in this list in proper sequence (from first to last element).

Public Constructors

public RoleList ()

Constructs an empty RoleList.

public RoleList (int initialCapacity)

Constructs an empty RoleList with the initial capacity specified.

Parameters

initialCapacity	initial capacity

public RoleList (List<Role> list)

Constructs a RoleList containing the elements of the List specified, in the order in which they are returned by the List's iterator. The RoleList instance has an initial capacity of 110% of the size of the List specified.

Parameters

list	the `List` that defines the initial contents of the new `RoleList`.

Throws

IllegalArgumentException	if the `list` parameter is `null` or if the `list` parameter contains any non-Role objects.

Public Methods

public void add (int index, Role role)

Inserts the role specified as an element at the position specified. Elements with an index greater than or equal to the current position are shifted up.

Parameters

index	The position in the list where the new Role object is to be inserted.
role	The Role object to be inserted.

Throws

IllegalArgumentException	if the role is null.
IndexOutOfBoundsException	if accessing with an index outside of the list.

public void add (int index, Object element)

Inserts the specified element at the specified position in this list. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

Parameters

index	index at which the specified element is to be inserted
element	element to be inserted

public void add (Role role)

Adds the Role specified as the last element of the list.

Parameters

role	the role to be added.

Throws

IllegalArgumentException	if the role is null.

public boolean add (Object o)

Appends the specified element to the end of this list.

Parameters

o	element to be appended to this list

Returns

true (as specified by add(E))

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

Inserts all of the elements in the specified collection into this list, starting at the specified position. Shifts the element currently at that position (if any) and any subsequent elements to the right (increases their indices). The new elements will appear in the list in the order that they are returned by the specified collection's iterator.

Parameters

index	index at which to insert the first element from the specified collection
c	collection containing elements to be added to this list

Returns

true if this list changed as a result of the call

public boolean addAll (int index, RoleList roleList)

Inserts all of the elements in the RoleList specified into this list, starting at the specified position, in the order in which they are returned by the Iterator of the RoleList specified.

Parameters

index	Position at which to insert the first element from the RoleList specified.
roleList	Elements to be inserted into the list.

Returns

true if this list changed as a result of the call.

Throws

IllegalArgumentException	if the role is null.
IndexOutOfBoundsException	if accessing with an index outside of the list.

public boolean addAll (RoleList roleList)

Appends all the elements in the RoleList specified to the end of the list, in the order in which they are returned by the Iterator of the RoleList specified.

Parameters

roleList	Elements to be inserted into the list (can be null)

Returns

true if this list changed as a result of the call.

Throws

IndexOutOfBoundsException	if accessing with an index outside of the list.

public boolean addAll (Collection<?> c)

Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator. The behavior of this operation is undefined if the specified collection is modified while the operation is in progress. (This implies that the behavior of this call is undefined if the specified collection is this list, and this list is nonempty.)

Parameters

c	collection containing elements to be added to this list

Returns

true if this list changed as a result of the call

public List<Role> asList ()

Return a view of this list as a List<Role>. Changes to the returned value are reflected by changes to the original RoleList and vice versa.

Returns

a List<Role> whose contents reflect the contents of this RoleList.
If this method has ever been called on a given RoleList instance, a subsequent attempt to add an object to that instance which is not a Role will fail with an IllegalArgumentException. For compatibility reasons, a RoleList on which this method has never been called does allow objects other than Roles to be added.

Throws

IllegalArgumentException	if this `RoleList` contains an element that is not a `Role`.

public void set (int index, Role role)

Sets the element at the position specified to be the role specified. The previous element at that position is discarded.

Parameters

index	The position specified.
role	The value to which the role element should be set.

Throws

IllegalArgumentException	if the role is null.
IndexOutOfBoundsException	if accessing with an index outside of the list.

public Object set (int index, Object element)

Replaces the element at the specified position in this list with the specified element.

Parameters

index	index of the element to replace
element	element to be stored at the specified position

Returns

the element previously at the specified position

Interfaces

Classes

Exceptions

RoleList

Class Overview

Summary

Public Constructors

public RoleList ()

public RoleList (int initialCapacity)

Parameters

public RoleList (List<Role> list)

Parameters

Throws

See Also

Public Methods

public void add (int index, Role role)

Parameters

Throws

public void add (int index, Object element)

Parameters

public void add (Role role)

Parameters

Throws

public boolean add (Object o)

Parameters

Returns

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

Parameters

Returns

public boolean addAll (int index, RoleList roleList)

Parameters

Returns

Throws

See Also

public boolean addAll (RoleList roleList)

Parameters

Returns

Throws

See Also

public boolean addAll (Collection<?> c)

Parameters

Returns

public List<Role> asList ()

Returns

Throws

public void set (int index, Role role)

Parameters

Throws

public Object set (int index, Object element)

Parameters

Returns