Class DefaultListModel

public void add(int index,
                Object element)

Inserts an element at a particular index in the list. Each element at index i >= index is shifted to position i + 1. If index is equal to size(), this is equivalent to appending an element to the array. Any index greater than size() is illegal.

Parameters:

index - The index to insert the element at

element - The element to insert at the index

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds [0, size()]

public void addElement(Object element)

Inserts an element at the end of the list. This is equivalent to calling list.add(list.size(), element).

Parameters:

element - The element to add to the list

public int capacity()

Gets the capacity of the list. The list's capacity is the number of elements it can hold before it needs to be reallocated.

Returns:

The capacity of the list

public void clear()

Erases all the elements of the list, setting the list's size to 0.

public boolean contains(Object element)

Determines whether a particular element is a member of the list.

Parameters:

element - The element to search for

Returns:

true if element is a member of the list, otherwise false

public void copyInto(Object[] array)

Copies the list into a provided array. The provided array must be at least as large as the list.

Parameters:

array - The array to copy the list into

Throws:

IndexOutOfBoundsException - if the array is too small to hold the elements of the list

public Object elementAt(int index)

Gets an element of the list at the provided index.

Parameters:

index - The index of the element to get

Returns:

The object at the given index

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public Enumeration elements()

Returns an Enumeration over the elements of the list.

Returns:

A new enumeration which iterates over the list

public void ensureCapacity(int size)

Ensures that the list's capacity is at least equal to size. The list's capacity is the number of elements it can hold before it needs to be reallocated.

Parameters:

size - The capacity to ensure the list can hold

public Object firstElement()

Gets the first element in the list.

Returns:

The first element in the list

public Object get(int index)

Gets the list element at a particular index.

Parameters:

index - The index to get the list value at

Returns:

The list value at the provided index

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public Object getElementAt(int index)

Gets the list element at a particular index.

Specified by:

getElementAt in interface ListModel

Parameters:

index - The index to get the list value at

Returns:

The list value at the provided index

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public int getSize()

Gets the size of the list.

Specified by:

getSize in interface ListModel

Returns:

The number of elements currently in the list

public int indexOf(Object element)

Gets the first index of a particular element in the list.

Parameters:

element - The element to search for

Returns:

The first index in the list at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

public int indexOf(Object element,
                   int startIndex)

Gets the first index of a particular element in a list which occurs at or after a particular index.

Parameters:

element - The element to search for

startIndex - The index to begin searching at

Returns:

The first index in the list, greater than or equal to startIndex, at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

public void insertElementAt(Object element,
                            int index)

Inserts an element at a particular index in the list. Each element at index i >= index is shifted to position i + 1. If index is equal to size(), this is equivalent to appending an element to the array. Any index greater than size() is illegal.

Parameters:

element - The element to insert at the index

index - The index to insert the element at

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds [0, size()]

public boolean isEmpty()

Determines whether the list is empty.

Returns:

true if the list is empty, otherwise false

public Object lastElement()

Gets the last element in the list.

Returns:

The last element in the list

public int lastIndexOf(Object element)

Gets the last index of a particular element in the list.

Parameters:

element - The element to search for

Returns:

The last index in the list at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

public int lastIndexOf(Object element,
                       int endIndex)

Gets the last index of a particular element in a list which occurs at or before a particular index.

Parameters:

element - The element to search for

endIndex - The index to finish searching at

Returns:

The last index in the list, less than to or equal to endIndexIndex, at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

public Object remove(int index)

Removes the element at a particular index from the list.

Parameters:

index - The index of the element to remove

Returns:

The value at the index, which has been removed from the list

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public void removeAllElements()

Remove all elements in the list.

public boolean removeElement(Object element)

Removes the first occurrence of a particular element in the list. If the element does not exist in the list, nothing happens.

Parameters:

element - The element to remove

Returns:

true if the element existed in the list (and was removed), false otherwise

public void removeElementAt(int index)

Removes the element at a particular index from the list.

Parameters:

index - The index of the element to remove

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public void removeRange(int startIndex,
                        int endIndex)

Remove all elements between startIndex and endIndex inclusive.

Parameters:

startIndex - The first index in the range to remove

endIndex - The last index in the range to remove

Throws:

ArrayIndexOutOfBoundsException - if either index is outside the valid range of indices for this list [0, size())

IllegalArgumentException - if startIndex > endIndex

public Object set(int index,
                  Object element)

Sets the list element at a particular index.

Parameters:

index - The list index at which to set a value

element - The value to set at the specified index

Returns:

The value previously held at the specified index

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public void setElementAt(Object element,
                         int index)

Sets the list element at a particular index.

Parameters:

element - The value to set at the specified index

index - The list index at which to set a value

Throws:

ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

public void setSize(int size)

Sets the size of the list to a particular value. If the specified size is greater than the current size, the values at the excess list indices are set to null. If the specified size is less than the current size, the excess elements are removed from the list.

Parameters:

size - The new size to set the list to

public int size()

Gets the number of elements in the list.

Returns:

The number of elements in the list

public Object[] toArray()

Gets an array containing the elements of the list.

Returns:

An array of the objects in the list, in the order they occur in the list

public String toString()

Convert the list to a string representation.

Overrides:

toString in interface Object

Returns:

A string representation of the list

public void trimToSize()

Sets the capacity of the list to be equal to its size. The list's capacity is the number of elements it can hold before it needs to be reallocated. The list's size is the number of elements it currently holds.