Module java.desktop
Package javax.swing

Class DefaultListModel<E>

java.lang.Object
javax.swing.AbstractListModel<E>
javax.swing.DefaultListModel<E>
Type Parameters:
E - the type of the elements of this model
All Implemented Interfaces:
Serializable, ListModel<E>

public class DefaultListModel<E>
extends AbstractListModel<E>
This class loosely implements the java.util.Vector API, in that it implements the 1.1.x version of java.util.Vector, has no collection class support, and notifies the ListDataListeners when changes occur. Presently it delegates to a Vector, in a future release it will be a real Collection implementation.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans™ has been added to the java.beans package. Please see XMLEncoder.

Since:
1.2
  • Field Summary

    Fields declared in class javax.swing.AbstractListModel

    listenerList
  • Constructor Summary

    Constructors
    Constructor Description
    DefaultListModel()  
  • Method Summary

    Modifier and Type Method Description
    void add​(int index, E element)
    Inserts the specified element at the specified position in this list.
    void addAll​(int index, Collection<? extends E> c)
    Adds all of the elements present in the collection, starting from the specified index.
    void addAll​(Collection<? extends E> c)
    Adds all of the elements present in the collection to the list.
    void addElement​(E element)
    Adds the specified component to the end of this list.
    int capacity()
    Returns the current capacity of this list.
    void clear()
    Removes all of the elements from this list.
    boolean contains​(Object elem)
    Tests whether the specified object is a component in this list.
    void copyInto​(Object[] anArray)
    Copies the components of this list into the specified array.
    E elementAt​(int index)
    Returns the component at the specified index.
    Enumeration<E> elements()
    Returns an enumeration of the components of this list.
    void ensureCapacity​(int minCapacity)
    Increases the capacity of this list, if necessary, to ensure that it can hold at least the number of components specified by the minimum capacity argument.
    E firstElement()
    Returns the first component of this list.
    E get​(int index)
    Returns the element at the specified position in this list.
    E getElementAt​(int index)
    Returns the component at the specified index.
    int getSize()
    Returns the number of components in this list.
    int indexOf​(Object elem)
    Searches for the first occurrence of elem.
    int indexOf​(Object elem, int index)
    Searches for the first occurrence of elem, beginning the search at index.
    void insertElementAt​(E element, int index)
    Inserts the specified element as a component in this list at the specified index.
    boolean isEmpty()
    Tests whether this list has any components.
    E lastElement()
    Returns the last component of the list.
    int lastIndexOf​(Object elem)
    Returns the index of the last occurrence of elem.
    int lastIndexOf​(Object elem, int index)
    Searches backwards for elem, starting from the specified index, and returns an index to it.
    E remove​(int index)
    Removes the element at the specified position in this list.
    void removeAllElements()
    Removes all components from this list and sets its size to zero.
    boolean removeElement​(Object obj)
    Removes the first (lowest-indexed) occurrence of the argument from this list.
    void removeElementAt​(int index)
    Deletes the component at the specified index.
    void removeRange​(int fromIndex, int toIndex)
    Deletes the components at the specified range of indexes.
    E set​(int index, E element)
    Replaces the element at the specified position in this list with the specified element.
    void setElementAt​(E element, int index)
    Sets the component at the specified index of this list to be the specified element.
    void setSize​(int newSize)
    Sets the size of this list.
    int size()
    Returns the number of components in this list.
    Object[] toArray()
    Returns an array containing all of the elements in this list in the correct order.
    String toString()
    Returns a string that displays and identifies this object's properties.
    void trimToSize()
    Trims the capacity of this list to be the list's current size.

    Methods declared in class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • DefaultListModel

      public DefaultListModel()
  • Method Details

    • getSize

      public int getSize()
      Returns the number of components in this list.

      This method is identical to size, which implements the List interface defined in the 1.2 Collections framework. This method exists in conjunction with setSize so that size is identifiable as a JavaBean property.

      Returns:
      the number of components in this list
      See Also:
      size()
    • getElementAt

      public E getElementAt​(int index)
      Returns the component at the specified index.
      Note: Although this method is not deprecated, the preferred method to use is get(int), which implements the List interface defined in the 1.2 Collections framework.
      Parameters:
      index - an index into this list
      Returns:
      the component at the specified index
      Throws:
      ArrayIndexOutOfBoundsException - if the index is negative or greater than the current size of this list
      See Also:
      get(int)
    • copyInto

      public void copyInto​(Object[] anArray)
      Copies the components of this list into the specified array. The array must be big enough to hold all the objects in this list, else an IndexOutOfBoundsException is thrown.
      Parameters:
      anArray - the array into which the components get copied
      See Also:
      Vector.copyInto(Object[])
    • trimToSize

      public void trimToSize()
      Trims the capacity of this list to be the list's current size.
      See Also:
      Vector.trimToSize()
    • ensureCapacity

      public void ensureCapacity​(int minCapacity)
      Increases the capacity of this list, if necessary, to ensure that it can hold at least the number of components specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity
      See Also:
      Vector.ensureCapacity(int)
    • setSize

      public void setSize​(int newSize)
      Sets the size of this list.
      Parameters:
      newSize - the new size of this list
      See Also:
      Vector.setSize(int)
    • capacity

      public int capacity()
      Returns the current capacity of this list.
      Returns:
      the current capacity
      See Also:
      Vector.capacity()
    • size

      public int size()
      Returns the number of components in this list.
      Returns:
      the number of components in this list
      See Also:
      Vector.size()
    • isEmpty

      public boolean isEmpty()
      Tests whether this list has any components.
      Returns:
      true if and only if this list has no components, that is, its size is zero; false otherwise
      See Also:
      Vector.isEmpty()
    • elements

      public Enumeration<E> elements()
      Returns an enumeration of the components of this list.
      Returns:
      an enumeration of the components of this list
      See Also:
      Vector.elements()
    • contains

      public boolean contains​(Object elem)
      Tests whether the specified object is a component in this list.
      Parameters:
      elem - an object
      Returns:
      true if the specified object is the same as a component in this list
      See Also:
      Vector.contains(Object)
    • indexOf

      public int indexOf​(Object elem)
      Searches for the first occurrence of elem.
      Parameters:
      elem - an object
      Returns:
      the index of the first occurrence of the argument in this list; returns -1 if the object is not found
      See Also:
      Vector.indexOf(Object)
    • indexOf

      public int indexOf​(Object elem, int index)
      Searches for the first occurrence of elem, beginning the search at index.
      Parameters:
      elem - the desired component
      index - the index from which to begin searching
      Returns:
      the index where the first occurrence of elem is found after index; returns -1 if the elem is not found in the list
      See Also:
      Vector.indexOf(Object,int)
    • lastIndexOf

      public int lastIndexOf​(Object elem)
      Returns the index of the last occurrence of elem.
      Parameters:
      elem - the desired component
      Returns:
      the index of the last occurrence of elem in the list; returns elem if the object is not found
      See Also:
      Vector.lastIndexOf(Object)
    • lastIndexOf

      public int lastIndexOf​(Object elem, int index)
      Searches backwards for elem, starting from the specified index, and returns an index to it.
      Parameters:
      elem - the desired component
      index - the index to start searching from
      Returns:
      the index of the last occurrence of the elem in this list at position less than index; returns -1 if the object is not found
      See Also:
      Vector.lastIndexOf(Object,int)
    • elementAt

      public E elementAt​(int index)
      Returns the component at the specified index.
      Note: Although this method is not deprecated, the preferred method to use is get(int), which implements the List interface defined in the 1.2 Collections framework.
      Parameters:
      index - an index into this list
      Returns:
      the component at the specified index
      Throws:
      ArrayIndexOutOfBoundsException - if the index is negative or not less than the size of the list
      See Also:
      get(int), Vector.elementAt(int)
    • firstElement

      public E firstElement()
      Returns the first component of this list.
      Returns:
      the first component of this list
      Throws:
      NoSuchElementException - if this vector has no components
      See Also:
      Vector.firstElement()
    • lastElement

      public E lastElement()
      Returns the last component of the list.
      Returns:
      the last component of the list
      Throws:
      NoSuchElementException - if this vector has no components
      See Also:
      Vector.lastElement()
    • setElementAt

      public void setElementAt​(E element, int index)
      Sets the component at the specified index of this list to be the specified element. The previous component at that position is discarded.
      Note: Although this method is not deprecated, the preferred method to use is set(int,Object), which implements the List interface defined in the 1.2 Collections framework.
      Parameters:
      element - what the component is to be set to
      index - the specified index
      Throws:
      ArrayIndexOutOfBoundsException - if the index is invalid
      See Also:
      set(int,Object), Vector.setElementAt(Object,int)
    • removeElementAt

      public void removeElementAt​(int index)
      Deletes the component at the specified index.
      Note: Although this method is not deprecated, the preferred method to use is remove(int), which implements the List interface defined in the 1.2 Collections framework.
      Parameters:
      index - the index of the object to remove
      Throws:
      ArrayIndexOutOfBoundsException - if the index is invalid
      See Also:
      remove(int), Vector.removeElementAt(int)
    • insertElementAt

      public void insertElementAt​(E element, int index)
      Inserts the specified element as a component in this list at the specified index.
      Note: Although this method is not deprecated, the preferred method to use is add(int,Object), which implements the List interface defined in the 1.2 Collections framework.
      Parameters:
      element - the component to insert
      index - where to insert the new component
      Throws:
      ArrayIndexOutOfBoundsException - if the index was invalid
      See Also:
      add(int,Object), Vector.insertElementAt(Object,int)
    • addElement

      public void addElement​(E element)
      Adds the specified component to the end of this list.
      Parameters:
      element - the component to be added
      See Also:
      Vector.addElement(Object)
    • removeElement

      public boolean removeElement​(Object obj)
      Removes the first (lowest-indexed) occurrence of the argument from this list.
      Parameters:
      obj - the component to be removed
      Returns:
      true if the argument was a component of this list; false otherwise
      See Also:
      Vector.removeElement(Object)
    • removeAllElements

      public void removeAllElements()
      Removes all components from this list and sets its size to zero.
      Note: Although this method is not deprecated, the preferred method to use is clear, which implements the List interface defined in the 1.2 Collections framework.
      See Also:
      clear(), Vector.removeAllElements()
    • toString

      public String toString()
      Returns a string that displays and identifies this object's properties.
      Overrides:
      toString in class Object
      Returns:
      a String representation of this object
    • toArray

      public Object[] toArray()
      Returns an array containing all of the elements in this list in the correct order.
      Returns:
      an array containing the elements of the list
      See Also:
      Vector.toArray()
    • get

      public E get​(int index)
      Returns the element at the specified position in this list.
      Parameters:
      index - index of element to return
      Returns:
      the element at the specified position in this list
      Throws:
      ArrayIndexOutOfBoundsException - if the index is out of range (index &lt; 0 || index &gt;= size())
    • set

      public E set​(int index, E element)
      Replaces the element at the specified position in this list with the specified element.
      Parameters:
      index - index of element to replace
      element - element to be stored at the specified position
      Returns:
      the element previously at the specified position
      Throws:
      ArrayIndexOutOfBoundsException - if the index is out of range (index &lt; 0 || index &gt;= size())
    • add

      public void add​(int index, E element)
      Inserts the specified element at the specified position in this list.
      Parameters:
      index - index at which the specified element is to be inserted
      element - element to be inserted
      Throws:
      ArrayIndexOutOfBoundsException - if the index is out of range (index &lt; 0 || index &gt; size())
    • remove

      public E remove​(int index)
      Removes the element at the specified position in this list. Returns the element that was removed from the list
      Parameters:
      index - the index of the element to removed
      Returns:
      the element previously at the specified position
      Throws:
      ArrayIndexOutOfBoundsException - if the index is out of range (index &lt; 0 || index &gt;= size())
    • clear

      public void clear()
      Removes all of the elements from this list. The list will be empty after this call returns (unless it throws an exception).
    • removeRange

      public void removeRange​(int fromIndex, int toIndex)
      Deletes the components at the specified range of indexes. The removal is inclusive, so specifying a range of (1,5) removes the component at index 1 and the component at index 5, as well as all components in between.
      Parameters:
      fromIndex - the index of the lower end of the range
      toIndex - the index of the upper end of the range
      Throws:
      ArrayIndexOutOfBoundsException - if the index was invalid
      IllegalArgumentException - if fromIndex &gt; toIndex
      See Also:
      remove(int)
    • addAll

      public void addAll​(Collection<? extends E> c)
      Adds all of the elements present in the collection to the list.
      Parameters:
      c - the collection which contains the elements to add
      Throws:
      NullPointerException - if c is null
    • addAll

      public void addAll​(int index, Collection<? extends E> c)
      Adds all of the elements present in the collection, starting from the specified index.
      Parameters:
      index - index at which to insert the first element from the specified collection
      c - the collection which contains the elements to add
      Throws:
      ArrayIndexOutOfBoundsException - if index does not fall within the range of number of elements currently held
      NullPointerException - if c is null