- java.lang.Object
-
- java.util.AbstractCollection<E>
-
- java.util.AbstractList<E>
-
- java.util.ArrayList<Object>
-
- javax.management.relation.RoleList
-
- All Implemented Interfaces:
- Serializable, Cloneable, Iterable<Object>, Collection<Object>, List<Object>, RandomAccess
public class RoleList extends ArrayList<Object>
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.- Since:
- 1.5
- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class java.util.AbstractList
modCount
-
-
Constructor Summary
Constructors Constructor and Description RoleList()
Constructs an empty RoleList.RoleList(int initialCapacity)
Constructs an empty RoleList with the initial capacity specified.RoleList(List<Role> list)
Constructs aRoleList
containing the elements of theList
specified, in the order in which they are returned by theList
's iterator.
-
Method Summary
Methods Modifier and Type Method and Description void
add(int index, Object element)
Inserts the specified element at the specified position in this list.void
add(int index, Role role)
Inserts the role specified as an element at the position specified.boolean
add(Object o)
Appends the specified element to the end of this list.void
add(Role role)
Adds the Role specified as the last element of the list.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.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.List<Role>
asList()
Return a view of this list as aList<Role>
.Object
set(int index, Object element)
Replaces the element at the specified position in this list with the specified element.void
set(int index, Role role)
Sets the element at the position specified to be the role specified.-
Methods inherited from class java.util.ArrayList
clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeRange, retainAll, size, subList, toArray, toArray, trimToSize
-
Methods inherited from class java.util.AbstractCollection
containsAll, toString
-
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface java.util.List
containsAll, equals, hashCode
-
-
-
-
Constructor Detail
-
RoleList
public RoleList()
Constructs an empty RoleList.
-
RoleList
public RoleList(int initialCapacity)
Constructs an empty RoleList with the initial capacity specified.- Parameters:
initialCapacity
- initial capacity
-
RoleList
public RoleList(List<Role> list) throws IllegalArgumentException
Constructs aRoleList
containing the elements of theList
specified, in the order in which they are returned by theList
's iterator. TheRoleList
instance has an initial capacity of 110% of the size of theList
specified.- Parameters:
list
- theList
that defines the initial contents of the newRoleList
.- Throws:
IllegalArgumentException
- if thelist
parameter isnull
or if thelist
parameter contains any non-Role objects.- See Also:
ArrayList.ArrayList(java.util.Collection)
-
-
Method Detail
-
asList
public List<Role> asList()
Return a view of this list as aList<Role>
. Changes to the returned value are reflected by changes to the originalRoleList
and vice versa.- Returns:
- a
List<Role>
whose contents reflect the contents of thisRoleList
.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 aRole
will fail with anIllegalArgumentException
. For compatibility reasons, aRoleList
on which this method has never been called does allow objects other thanRole
s to be added. - Throws:
IllegalArgumentException
- if thisRoleList
contains an element that is not aRole
.- Since:
- 1.6
-
add
public void add(Role role) throws IllegalArgumentException
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.
-
add
public void add(int index, Role role) throws IllegalArgumentException, IndexOutOfBoundsException
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.
-
set
public void set(int index, Role role) throws IllegalArgumentException, IndexOutOfBoundsException
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.
-
addAll
public boolean addAll(RoleList roleList) throws IndexOutOfBoundsException
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.- See Also:
ArrayList.addAll(Collection)
-
addAll
public boolean addAll(int index, RoleList roleList) throws IllegalArgumentException, IndexOutOfBoundsException
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.- See Also:
ArrayList.addAll(int, Collection)
-
add
public boolean add(Object o)
Description copied from class:ArrayList
Appends the specified element to the end of this list.- Specified by:
add
in interfaceCollection<Object>
- Specified by:
add
in interfaceList<Object>
- Overrides:
add
in classArrayList<Object>
- Parameters:
o
- element to be appended to this list- Returns:
- true (as specified by
Collection.add(E)
)
-
add
public void add(int index, Object element)
Description copied from class:ArrayList
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).
-
addAll
public boolean addAll(Collection<?> c)
Description copied from class:ArrayList
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.)- Specified by:
addAll
in interfaceCollection<Object>
- Specified by:
addAll
in interfaceList<Object>
- Overrides:
addAll
in classArrayList<Object>
- Parameters:
c
- collection containing elements to be added to this list- Returns:
- true if this list changed as a result of the call
- See Also:
AbstractCollection.add(Object)
-
addAll
public boolean addAll(int index, Collection<?> c)
Description copied from class:ArrayList
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.- Specified by:
addAll
in interfaceList<Object>
- Overrides:
addAll
in classArrayList<Object>
- Parameters:
index
- index at which to insert the first element from the specified collectionc
- collection containing elements to be added to this list- Returns:
- true if this list changed as a result of the call
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/management/relation/rolelist.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.