javax.management: public class: AttributeList

javax.management
public class: AttributeList [javadoc | source]

java.lang.Object
   java.util.AbstractCollection<E>
      java.util.AbstractList<E>
         java.util.ArrayList<Object>
            javax.management.AttributeList

All Implemented Interfaces:
Cloneable, List, Serializable, RandomAccess, Collection

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 {@code AttributeList} that are not instances of {@code Attribute}. However, an {@code AttributeList} can be made type-safe, which means that an attempt to add an object that is not an {@code Attribute} will produce an {@code IllegalArgumentException}. An {@code AttributeList} becomes type-safe when the method #asList() is called on it.

since: 1.5 -

Fields inherited from java.util.AbstractList:
modCount

Constructor:

Constructor:
public AttributeList() { super(); } Constructs an empty `AttributeList`.
public AttributeList(int initialCapacity) { super(initialCapacity); } Constructs an empty `AttributeList` with the initial capacity specified. Parameters: `initialCapacity` - the initial capacity of the `AttributeList`, as specified by ArrayList#ArrayList(int) .
public AttributeList(AttributeList list) { super(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` - the `AttributeList` that defines the initial contents of the new `AttributeList`. Also see: ArrayList#ArrayList(java.util.Collection)
public AttributeList(List<Attribute> list) { // Check for null parameter // if (list == null) throw new IllegalArgumentException("Null parameter"); // Check for non-Attribute objects // adding(list); // Build the List< Attribute > // super.addAll(list); } Constructs an {@code AttributeList} containing the elements of the {@code List} specified, in the order in which they are returned by the {@code List}'s iterator. Parameters: `list` - the {@code List} that defines the initial contents of the new {@code AttributeList}. Throws: `IllegalArgumentException` - if the {@code list} parameter is {@code null} or if the {@code list} parameter contains any non-Attribute objects. Also see: ArrayList#ArrayList(java.util.Collection) exception: `IllegalArgumentException` - if the {@code list} parameter is {@code null} or if the {@code list} parameter contains any non-Attribute objects. since: `1.6` -

 public AttributeList() {
        super();
}

Constructs an empty AttributeList.

 public AttributeList(int initialCapacity) {
        super(initialCapacity);
}

Constructs an empty AttributeList with the initial capacity specified.

Parameters:

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

 public AttributeList(AttributeList list) {
        super(list);
}

AttributeList

Parameters:

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

Also see:

ArrayList#ArrayList(java.util.Collection)

 public AttributeList(List<Attribute> list) {
        // Check for null parameter
        //
        if (list == null)
            throw new IllegalArgumentException("Null parameter");
        // Check for non-Attribute objects
        //
        adding(list);
        // Build the List< Attribute >
        //
        super.addAll(list);
}

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

Parameters:

list - the {@code List} that defines the initial contents of the new {@code AttributeList}.

Throws:

IllegalArgumentException - if the {@code list} parameter is {@code null} or if the {@code list} parameter contains any non-Attribute objects.

Also see:

ArrayList#ArrayList(java.util.Collection)

exception: IllegalArgumentException - if the {@code list} parameter is {@code null} or if the {@code list} parameter contains any non-Attribute objects.

since: 1.6 -

Method from javax.management.AttributeList Summary:
add, add, add, add, addAll, addAll, addAll, addAll, asList, set, set

Methods from java.util.ArrayList:
add, add, addAll, addAll, clear, clone, contains, elementData, ensureCapacity, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeRange, retainAll, set, size, subList, subListRangeCheck, toArray, toArray, trimToSize

Methods from java.util.AbstractList:
add, add, addAll, clear, equals, get, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, removeRange, set, subList

Methods from java.util.AbstractCollection:
add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.management.AttributeList Detail:
public void add(Attribute object) { super.add(object); } Adds the {@code Attribute} specified as the last element of the list.
public boolean add(Object element) { adding(element); return super.add(element); } {@inheritDoc}
public void add(int index, Attribute object) { try { super.add(index, object); } catch (IndexOutOfBoundsException e) { throw new RuntimeOperationsException(e, "The specified index is out of range"); } } 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.
public void add(int index, Object element) { adding(element); super.add(index, element); } {@inheritDoc}
public boolean addAll(AttributeList list) { return (super.addAll(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 addAll(Collection<?> c) { adding(c); return super.addAll(c); } {@inheritDoc}
public boolean addAll(int index, AttributeList list) { try { return super.addAll(index, list); } catch (IndexOutOfBoundsException e) { throw new RuntimeOperationsException(e, "The specified index is out of range"); } } 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 {@code AttributeList} specified. If the index is out of range (index < 0 \|\| index > size() a RuntimeOperationsException should be raised, wrapping the java.lang.IndexOutOfBoundsException thrown.
public boolean addAll(int index, Collection<?> c) { adding(c); return super.addAll(index, c); } {@inheritDoc}
public List<Attribute> asList() { typeSafe = true; if (tainted) adding((Collection< ? >) this); // will throw IllegalArgumentException return (List< Attribute >) (List< ? >) this; } Return a view of this list as a {@code List}. Changes to the returned value are reflected by changes to the original {@code AttributeList} and vice versa.
public void set(int index, Attribute object) { try { super.set(index, object); } catch (IndexOutOfBoundsException e) { throw new RuntimeOperationsException(e, "The specified index is out of range"); } } 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.
public Object set(int index, Object element) { adding(element); return super.set(index, element); } {@inheritDoc}

Method from javax.management.AttributeList Detail:

 public  void add(Attribute object) {
        super.add(object);
}

Adds the {@code Attribute} specified as the last element of the list.

 public boolean add(Object element) {
        adding(element);
        return super.add(element);
}

{@inheritDoc}

 public  void add(int index,
    Attribute object) {
        try {
            super.add(index, object);
        }
        catch (IndexOutOfBoundsException e) {
            throw new RuntimeOperationsException(e,
                "The specified index is out of range");
        }
}

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.

 public  void add(int index,
    Object element) {
        adding(element);
        super.add(index, element);
}

{@inheritDoc}

 public boolean addAll(AttributeList list) {
        return (super.addAll(list));
}

AttributeList

 public boolean addAll(Collection<?> c) {
        adding(c);
        return super.addAll(c);
}

{@inheritDoc}

 public boolean addAll(int index,
    AttributeList list) {
        try {
            return super.addAll(index, list);
        } catch (IndexOutOfBoundsException e) {
            throw new RuntimeOperationsException(e,
                "The specified index is out of range");
        }
}

AttributeList

 public boolean addAll(int index,
    Collection<?> c) {
        adding(c);
        return super.addAll(index, c);
}

{@inheritDoc}

 public List<Attribute> asList() {
        typeSafe = true;
        if (tainted)
            adding((Collection< ? >) this);  // will throw IllegalArgumentException
        return (List< Attribute >) (List< ? >) this;
}

}. Changes to the returned value are reflected by changes to the original {@code AttributeList} and vice versa.

 public  void set(int index,
    Attribute object) {
        try {
            super.set(index, object);
        }
        catch (IndexOutOfBoundsException e) {
            throw new RuntimeOperationsException(e,
                "The specified index is out of range");
        }
}

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.

 public Object set(int index,
    Object element) {
        adding(element);
        return super.set(index, element);
}

{@inheritDoc}