Top Description Fields Constructors Methods
javax.management

public Class AttributeList

extends ArrayList<Object>
Class Inheritance
Imports
java.util.ArrayList, .Collection, .LinkedHashMap, .List, .Map

Represents a list of values for attributes of an MBean. See the getAttributes and setAttributes methods of MBeanServer and MBeanServerConnection.

For compatibility reasons, it is possible, though highly discouraged, to add objects to an AttributeList that are not instances of Attribute. However, an AttributeList can be made type-safe, which means that an attempt to add an object that is not an Attribute will produce an IllegalArgumentException. An AttributeList becomes type-safe when the method asList() is called on it.

Since
1.5

Field Summary

Modifier and TypeField and Description
private static final long
serialVersionUID

Hides java.util.ArrayList.serialVersionUID.

private transient volatile boolean
tainted

private transient volatile boolean
typeSafe

Constructor Summary

AccessConstructor and Description
public
AttributeList()

Constructs an empty AttributeList.

public
AttributeList(int
the initial capacity of the AttributeList, as specified by ArrayList#ArrayList(int).
initialCapacity)

Constructs an empty AttributeList with the initial capacity specified.

public
AttributeList(AttributeList
the AttributeList that defines the initial contents of the new AttributeList.
list)

Constructs an AttributeList containing the elements of the AttributeList specified, in the order in which they are returned by the AttributeList's iterator.

public
AttributeList(List<Attribute>
the List that defines the initial contents of the new AttributeList.
list)

Constructs an AttributeList containing the elements of the List specified, in the order in which they are returned by the List's iterator.

Method Summary

Modifier and TypeMethod and Description
public void
add(Attribute
The attribute to be added.
object)

Overrides java.util.ArrayList.add.

Implements java.util.List.add, java.util.Collection.add.

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

public void
add(int
The position in the list where the new Attribute object is to be inserted.
index, Attribute
The Attribute object to be inserted.
object)

Overrides java.util.ArrayList.add.

Implements java.util.List.add.

Inserts the attribute specified as an element at the position specified.

public boolean
add(Object
element to be appended to this list
element)

Overrides java.util.ArrayList.add.

Implements java.util.List.add, java.util.Collection.add.

Appends the specified element to the end of this list.

public void
add(int
index at which the specified element is to be inserted
index, Object
element to be inserted
element)

Overrides java.util.ArrayList.add.

Implements java.util.List.add.

Inserts the specified element at the specified position in this list.

public boolean

Returns:

true if this list changed as a result of the call.
addAll(AttributeList
Elements to be inserted into the list.
list)

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

public boolean

Returns:

true if this list changed as a result of the call.
addAll(int
Position at which to insert the first element from the AttributeList specified.
index, AttributeList
Elements to be inserted into the list.
list)

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

public boolean
addAll(Collection<?>
collection containing elements to be added to this list
c)

Overrides java.util.ArrayList.addAll.

Implements java.util.List.addAll, java.util.Collection.addAll.

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.

public boolean
addAll(int
index at which to insert the first element from the specified collection
index, Collection<?>
collection containing elements to be added to this list
c)

Overrides java.util.ArrayList.addAll.

Implements java.util.List.addAll.

Inserts all of the elements in the specified collection into this list, starting at the specified position.

private void
adding(Object x)

private void
adding(Collection<?> c)

public List<Attribute>

Returns:

a List<Attribute> whose contents reflect the contents of this AttributeList.

If this method has ever been called on a given AttributeList instance, a subsequent attempt to add an object to that instance which is not an Attribute will fail with an IllegalArgumentException. For compatibility reasons, an AttributeList on which this method has never been called does allow objects other than Attributes to be added.

asList()

Return a view of this list as a List<Attribute>.

public void
set(int
The position specified.
index, Attribute
The value to which the attribute element should be set.
object)

Overrides java.util.ArrayList.set.

Implements java.util.List.set.

Sets the element at the position specified to be the attribute specified.

public Object
set(int
index of the element to replace
index, Object
element to be stored at the specified position
element)

Overrides java.util.ArrayList.set.

Implements java.util.List.set.

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

Inherited from java.util.ArrayList:
addFirstaddLastclearclonecontainsensureCapacityequalsforEachgetgetFirstgetLasthashCodeindexOfisEmptyiteratorlastIndexOflistIteratorlistIteratorremoveremoveremoveAllremoveFirstremoveIfremoveLastremoveRangereplaceAllretainAllsizesortspliteratorsubListtoArraytoArraytrimToSize

Field Detail

serialVersionUIDback to summary
private static final long serialVersionUID

Hides java.util.ArrayList.serialVersionUID.

taintedback to summary
private transient volatile boolean tainted
typeSafeback to summary
private transient volatile boolean typeSafe

Constructor Detail

AttributeListback to summary
public AttributeList()

Constructs an empty AttributeList.

AttributeListback to summary
public AttributeList(int initialCapacity)

Constructs an empty AttributeList with the initial capacity specified.

Parameters
initialCapacity:int

the initial capacity of the AttributeList, as specified by ArrayList#ArrayList(int).

AttributeListback to summary
public AttributeList(AttributeList list)

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

Parameters
list:AttributeList

the AttributeList that defines the initial contents of the new AttributeList.

See Also
ArrayList#ArrayList(java.util.Collection)
AttributeListback to summary
public AttributeList(List<Attribute> list)

Constructs an AttributeList containing the elements of the List specified, in the order in which they are returned by the List's iterator.

Parameters
list:List<Attribute>

the List that defines the initial contents of the new AttributeList.

Exceptions
IllegalArgumentException:
if the list parameter is null or if the list parameter contains any non-Attribute objects.
Since
1.6
See Also
ArrayList#ArrayList(java.util.Collection)

Method Detail

addback to summary
public void add(Attribute object)

Overrides java.util.ArrayList.add.

Implements java.util.List.add, java.util.Collection.add.

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

Parameters
object:Attribute

The attribute to be added.

Returns:void

Doc from java.util.ArrayList.add.

true (as specified by Collection#add)

addback to summary
public void add(int index, Attribute object)

Overrides java.util.ArrayList.add.

Implements java.util.List.add.

Inserts the attribute specified as an element at the position specified. Elements with an index greater than or equal to the current position are shifted up. If the index is out of range (index < 0 || index > size()) a RuntimeOperationsException should be raised, wrapping the java.lang.IndexOutOfBoundsException thrown.

Parameters
index:int

The position in the list where the new Attribute object is to be inserted.

object:Attribute

The Attribute object to be inserted.

addback to summary
public boolean add(Object element)

Overrides java.util.ArrayList.add.

Implements java.util.List.add, java.util.Collection.add.

Doc from java.util.ArrayList.add.

Appends the specified element to the end of this list.

Parameters
element:Object

element to be appended to this list

Returns:boolean

true (as specified by Collection#add)

Annotations
@Override
Exceptions
IllegalArgumentException:
if this AttributeList is type-safe and element is not an Attribute.
addback to summary
public void add(int index, Object element)

Overrides java.util.ArrayList.add.

Implements java.util.List.add.

Doc from java.util.ArrayList.add.

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:int

index at which the specified element is to be inserted

element:Object

element to be inserted

Annotations
@Override
Exceptions
IllegalArgumentException:
if this AttributeList is type-safe and element is not an Attribute.
addAllback to summary
public boolean addAll(AttributeList list)

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

Parameters
list:AttributeList

Elements to be inserted into the list.

Returns:boolean

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

See Also
ArrayList#addAll(java.util.Collection)
addAllback to summary
public boolean addAll(int index, AttributeList list)

Inserts all of the elements in the AttributeList specified into this list, starting at the specified position, in the order in which they are returned by the Iterator of the AttributeList specified. If the index is out of range (index < 0 || index > size()) a RuntimeOperationsException should be raised, wrapping the java.lang.IndexOutOfBoundsException thrown.

Parameters
index:int

Position at which to insert the first element from the AttributeList specified.

list:AttributeList

Elements to be inserted into the list.

Returns:boolean

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

See Also
ArrayList#addAll(int, java.util.Collection)
addAllback to summary
public boolean addAll(Collection<?> c)

Overrides java.util.ArrayList.addAll.

Implements java.util.List.addAll, java.util.Collection.addAll.

Doc from java.util.ArrayList.addAll.

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<?>

collection containing elements to be added to this list

Returns:boolean

true if this list changed as a result of the call

Annotations
@Override
Exceptions
IllegalArgumentException:
if this AttributeList is type-safe and c contains an element that is not an Attribute.
addAllback to summary
public boolean addAll(int index, Collection<?> c)

Overrides java.util.ArrayList.addAll.

Implements java.util.List.addAll.

Doc from java.util.ArrayList.addAll.

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:int

index at which to insert the first element from the specified collection

c:Collection<?>

collection containing elements to be added to this list

Returns:boolean

true if this list changed as a result of the call

Annotations
@Override
Exceptions
IllegalArgumentException:
if this AttributeList is type-safe and c contains an element that is not an Attribute.
addingback to summary
private void adding(Object x)
addingback to summary
private void adding(Collection<?> c)
asListback to summary
public List<Attribute> asList()

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

Returns:List<Attribute>

a List<Attribute> whose contents reflect the contents of this AttributeList.

If this method has ever been called on a given AttributeList instance, a subsequent attempt to add an object to that instance which is not an Attribute will fail with an IllegalArgumentException. For compatibility reasons, an AttributeList on which this method has never been called does allow objects other than Attributes to be added.

Annotations
@SuppressWarnings:unchecked
Exceptions
IllegalArgumentException:
if this AttributeList contains an element that is not an Attribute.
Since
1.6
setback to summary
public void set(int index, Attribute object)

Overrides java.util.ArrayList.set.

Implements java.util.List.set.

Sets the element at the position specified to be the attribute specified. The previous element at that position is discarded. If the index is out of range (index < 0 || index > size()) a RuntimeOperationsException should be raised, wrapping the java.lang.IndexOutOfBoundsException thrown.

Parameters
index:int

The position specified.

object:Attribute

The value to which the attribute element should be set.

Returns:void

Doc from java.util.ArrayList.set.

the element previously at the specified position

setback to summary
public Object set(int index, Object element)

Overrides java.util.ArrayList.set.

Implements java.util.List.set.

Doc from java.util.ArrayList.set.

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

Parameters
index:int

index of the element to replace

element:Object

element to be stored at the specified position

Returns:Object

the element previously at the specified position

Annotations
@Override
Exceptions
IllegalArgumentException:
if this AttributeList is type-safe and element is not an Attribute.