AbstractListModel (Java Platform SE 8 ) (original) (raw)

• java.lang.Object

• • javax.swing.AbstractListModel

• Type Parameters:
  E - the type of the elements of this model
  All Implemented Interfaces:
  Serializable, ListModel
  Direct Known Subclasses:
  BasicDirectoryModel, DefaultComboBoxModel, DefaultListModel, MetalFileChooserUI.DirectoryComboBoxModel, MetalFileChooserUI.FilterComboBoxModel

public abstract class AbstractListModel
extends Object
implements ListModel, Serializable
The abstract definition for the data model that provides a List with its contents.
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.

• • Field Summary

  Fields

  Modifier and Type	Field	Description
  protected EventListenerList	listenerList

  • Constructor Summary

  Constructors

  Constructor	Description
  AbstractListModel()

  • Method Summary

  All Methods Instance Methods Concrete Methods

  Modifier and Type	Method	Description
  void	addListDataListener(ListDataListener l)	Adds a listener to the list that's notified each time a change to the data model occurs.
  protected void	fireContentsChanged(Object source, int index0, int index1)	AbstractListModel subclasses must call this methodafter one or more elements of the list change.
  protected void	fireIntervalAdded(Object source, int index0, int index1)	AbstractListModel subclasses must call this methodafter one or more elements are added to the model.
  protected void	fireIntervalRemoved(Object source, int index0, int index1)	AbstractListModel subclasses must call this methodafter one or more elements are removed from the model.
  ListDataListener[]	getListDataListeners()	Returns an array of all the list data listeners registered on this AbstractListModel.
  <T extends EventListener>T[]	getListeners(Class listenerType)	Returns an array of all the objects currently registered as_Foo_Listeners upon this model.
  void	removeListDataListener(ListDataListener l)	Removes a listener from the list that's notified each time a change to the data model occurs.

     * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
     `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [toString](../../java/lang/Object.html#toString--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`  
     * ### Methods inherited from interface javax.swing.[ListModel](../../javax/swing/ListModel.html "interface in javax.swing")  
     `[getElementAt](../../javax/swing/ListModel.html#getElementAt-int-), [getSize](../../javax/swing/ListModel.html#getSize--)`

• • Field Detail

     * #### listenerList  
     protected [EventListenerList](../../javax/swing/event/EventListenerList.html "class in javax.swing.event") listenerList  

  • Constructor Detail

    * #### AbstractListModel  
    public AbstractListModel()  

  • Method Detail

    * #### addListDataListener  
    public void addListDataListener([ListDataListener](../../javax/swing/event/ListDataListener.html "interface in javax.swing.event") l)  
    Adds a listener to the list that's notified each time a change to the data model occurs.  
    Specified by:  
    `[addListDataListener](../../javax/swing/ListModel.html#addListDataListener-javax.swing.event.ListDataListener-)` in interface `[ListModel](../../javax/swing/ListModel.html "interface in javax.swing")<[E](../../javax/swing/AbstractListModel.html "type parameter in AbstractListModel")>`  
    Parameters:  
    `l` \- the `ListDataListener` to be added  
    * #### removeListDataListener  
    public void removeListDataListener([ListDataListener](../../javax/swing/event/ListDataListener.html "interface in javax.swing.event") l)  
    Removes a listener from the list that's notified each time a change to the data model occurs.  
    Specified by:  
    `[removeListDataListener](../../javax/swing/ListModel.html#removeListDataListener-javax.swing.event.ListDataListener-)` in interface `[ListModel](../../javax/swing/ListModel.html "interface in javax.swing")<[E](../../javax/swing/AbstractListModel.html "type parameter in AbstractListModel")>`  
    Parameters:  
    `l` \- the `ListDataListener` to be removed  
    * #### getListDataListeners  
    public [ListDataListener](../../javax/swing/event/ListDataListener.html "interface in javax.swing.event")[] getListDataListeners()  
    Returns an array of all the list data listeners registered on this `AbstractListModel`.  
    Returns:  
    all of this model's `ListDataListener`s, or an empty array if no list data listeners are currently registered  
    Since:  
    1.4  
    See Also:  
    [addListDataListener(javax.swing.event.ListDataListener)](../../javax/swing/AbstractListModel.html#addListDataListener-javax.swing.event.ListDataListener-), [removeListDataListener(javax.swing.event.ListDataListener)](../../javax/swing/AbstractListModel.html#removeListDataListener-javax.swing.event.ListDataListener-)  
    * #### fireContentsChanged  
    protected void fireContentsChanged([Object](../../java/lang/Object.html "class in java.lang") source,  
                                       int index0,  
                                       int index1)  
    `AbstractListModel` subclasses must call this method**after** one or more elements of the list change. The changed elements are specified by the closed interval index0, index1 -- the endpoints are included. Note that index0 need not be less than or equal to index1.  
    Parameters:  
    `source` \- the `ListModel` that changed, typically "this"  
    `index0` \- one end of the new interval  
    `index1` \- the other end of the new interval  
    See Also:  
    [EventListenerList](../../javax/swing/event/EventListenerList.html "class in javax.swing.event"), [DefaultListModel](../../javax/swing/DefaultListModel.html "class in javax.swing")  
    * #### fireIntervalAdded  
    protected void fireIntervalAdded([Object](../../java/lang/Object.html "class in java.lang") source,  
                                     int index0,  
                                     int index1)  
    `AbstractListModel` subclasses must call this method**after** one or more elements are added to the model. The new elements are specified by a closed interval index0, index1 -- the enpoints are included. Note that index0 need not be less than or equal to index1.  
    Parameters:  
    `source` \- the `ListModel` that changed, typically "this"  
    `index0` \- one end of the new interval  
    `index1` \- the other end of the new interval  
    See Also:  
    [EventListenerList](../../javax/swing/event/EventListenerList.html "class in javax.swing.event"), [DefaultListModel](../../javax/swing/DefaultListModel.html "class in javax.swing")  
    * #### fireIntervalRemoved  
    protected void fireIntervalRemoved([Object](../../java/lang/Object.html "class in java.lang") source,  
                                       int index0,  
                                       int index1)  
    `AbstractListModel` subclasses must call this method**after** one or more elements are removed from the model.`index0` and `index1` are the end points of the interval that's been removed. Note that `index0` need not be less than or equal to `index1`.  
    Parameters:  
    `source` \- the `ListModel` that changed, typically "this"  
    `index0` \- one end of the removed interval, including `index0`  
    `index1` \- the other end of the removed interval, including `index1`  
    See Also:  
    [EventListenerList](../../javax/swing/event/EventListenerList.html "class in javax.swing.event"), [DefaultListModel](../../javax/swing/DefaultListModel.html "class in javax.swing")  
    * #### getListeners  
    public <T extends [EventListener](../../java/util/EventListener.html "interface in java.util")> T[] getListeners([Class](../../java/lang/Class.html "class in java.lang")<T> listenerType)  
    Returns an array of all the objects currently registered as`_Foo_Listener`s upon this model.`_Foo_Listener`s are registered using the `add_Foo_Listener` method.  
     You can specify the `listenerType` argument with a class literal, such as `_Foo_Listener.class`. For example, you can query a list model`m` for its list data listeners with the following code:  
    ListDataListener[] ldls = (ListDataListener[])(m.getListeners(ListDataListener.class));  
     If no such listeners exist, this method returns an empty array.  
    Parameters:  
    `listenerType` \- the type of listeners requested; this parameter should specify an interface that descends from `java.util.EventListener`  
    Returns:  
    an array of all objects registered as`_Foo_Listener`s on this model, or an empty array if no such listeners have been added  
    Throws:  
    `[ClassCastException](../../java/lang/ClassCastException.html "class in java.lang")` \- if `listenerType` doesn't specify a class or interface that implements`java.util.EventListener`  
    Since:  
    1.3  
    See Also:  
    [getListDataListeners()](../../javax/swing/AbstractListModel.html#getListDataListeners--)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.