Module java.desktop
Package javax.swing.table

Interface TableModel

  • All Known Implementing Classes:
    AbstractTableModel, DefaultTableModel
    public interface TableModel
    The TableModel interface specifies the methods the JTable will use to interrogate a tabular data model.

    The JTable can be set up to display any data model which implements the TableModel interface with a couple of lines of code: 

          TableModel myData = new MyTableModel();
      JTable table = new JTable(myData);

    For further documentation, see Creating a Table Model in The Java Tutorial.

    See Also:
    JTable

    • Method Summary

      Modifier and Type Method Description
      void addTableModelListener​(TableModelListener l)
      Adds a listener to the list that is notified each time a change to the data model occurs.
      Class<?> getColumnClass​(int columnIndex)
      Returns the most specific superclass for all the cell values in the column.
      int getColumnCount()
      Returns the number of columns in the model.
      String getColumnName​(int columnIndex)
      Returns the name of the column at columnIndex.
      int getRowCount()
      Returns the number of rows in the model.
      Object getValueAt​(int rowIndex, int columnIndex)
      Returns the value for the cell at columnIndex and rowIndex.
      boolean isCellEditable​(int rowIndex, int columnIndex)
      Returns true if the cell at rowIndex and columnIndex is editable.
      void removeTableModelListener​(TableModelListener l)
      Removes a listener from the list that is notified each time a change to the data model occurs.
      void setValueAt​(Object aValue, int rowIndex, int columnIndex)
      Sets the value in the cell at columnIndex and rowIndex to aValue.

    • Method Detail

      • getRowCount

        int getRowCount()
        Returns the number of rows in the model. A JTable uses this method to determine how many rows it should display. This method should be quick, as it is called frequently during rendering.
        Returns:
        the number of rows in the model
        See Also:
        getColumnCount()

      • getColumnCount

        int getColumnCount()
        Returns the number of columns in the model. A JTable uses this method to determine how many columns it should create and display by default.
        Returns:
        the number of columns in the model
        See Also:
        getRowCount()

      • getColumnName

        String getColumnName​(int columnIndex)
        Returns the name of the column at columnIndex. This is used to initialize the table's column header name. Note: this name does not need to be unique; two columns in a table can have the same name.
        Parameters:
        columnIndex - the index of the column
        Returns:
        the name of the column

      • getColumnClass

        Class<?> getColumnClass​(int columnIndex)
        Returns the most specific superclass for all the cell values in the column. This is used by the JTable to set up a default renderer and editor for the column.
        Parameters:
        columnIndex - the index of the column
        Returns:
        the common ancestor class of the object values in the model.

      • isCellEditable

        boolean isCellEditable​(int rowIndex,
                       int columnIndex)
        Returns true if the cell at rowIndex and columnIndex is editable. Otherwise, setValueAt on the cell will not change the value of that cell.
        Parameters:
        rowIndex - the row whose value to be queried
        columnIndex - the column whose value to be queried
        Returns:
        true if the cell is editable
        See Also:
        setValueAt(java.lang.Object, int, int)

      • getValueAt

        Object getValueAt​(int rowIndex,
                  int columnIndex)
        Returns the value for the cell at columnIndex and rowIndex.
        Parameters:
        rowIndex - the row whose value is to be queried
        columnIndex - the column whose value is to be queried
        Returns:
        the value Object at the specified cell

      • setValueAt

        void setValueAt​(Object aValue,
                int rowIndex,
                int columnIndex)
        Sets the value in the cell at columnIndex and rowIndex to aValue.
        Parameters:
        aValue - the new value
        rowIndex - the row whose value is to be changed
        columnIndex - the column whose value is to be changed
        See Also:
        getValueAt(int, int), isCellEditable(int, int)

      • addTableModelListener

        void addTableModelListener​(TableModelListener l)
        Adds a listener to the list that is notified each time a change to the data model occurs.
        Parameters:
        l - the TableModelListener

      • removeTableModelListener

        void removeTableModelListener​(TableModelListener l)
        Removes a listener from the list that is notified each time a change to the data model occurs.
        Parameters:
        l - the TableModelListener