Swing-JTable用法-入门

注：本文为学习笔记，原文为How to Use Tables，本文所有素材与代码均源于原文，可能会有部分更改。

JTable是Swing中的表格控件，它的外观如下所示：

没错，excel或者access数据库的编辑区就是JTable这样的控件了。

创建JTable

JTable提供了2个构造器可以让你用数据和头部直接生成它：

JTable(Object[][] rowData, Object[] columnNames)
JTable(Vector rowData, Vector columnNames)

这两个构造器有一些特性你必须要注意：

1.JTable所有的单元格都是可编辑的；

2.它将所有数据都当做string来处理。本来，JTable可以将布尔型数据用一个checkBox来进行展示，就像表1那样，在这里就不行了。

3.它要求你把所有数据都放到数组或vector中。如果你的数据来自于数据库，那么专门再填充到数组实在是多此一举。

呐，如果你不能忍受以上限制，那么就使用table Model来管理你的数据吧!

创建TableModel

如果程序没有显式地指定tableModel，JTable会自动生成一个 DefaultTableModel实例，这样做的副作用在上面已经说过了。我们自己创建tableModel可以让数据得到更好的展示，这样做的方法是继承AbstractTableModel。它已经提供了tableModel接口的大部分默认实现，在最低限度下，你只需要实现以下三个方法：

public int getRowCount();

public int getColumnCount();

public Object getValueAt(int row, int column);

当然，如果你的应用程序有其他定制化的功能，你可以自己实现AbstractTableModel的其它方法，比如：

public Class getColumnClass(int c)//JTable uses this method to determine the default renderer editor for each cell

public boolean isCellEditable(int row, int col)//Don't need to implement this method unless your table's editable

public void setValueAt(Object value, int row, int col) //Don't need to implement this method unless your table's data can change.

TableDemo.java示意了如何自己创建并使用tableModel。 

将表格添加到容器中

一般情况下我们都是将JTable放到JScrollPane中，从而使用它的滚动功能。JScrollPane会很贴心地把表头放在表格上方，并在向下滑动时始终保持它可见。如果你就是不要用JScrollPane，那么记得在容器中添加表头哦~就像下面这样

container.setLayout(new BorderLayout());
container.add(table.getTableHeader(), BorderLayout.PAGE_START);
container.add(table, BorderLayout.CENTER);

设置和更改列宽

设置列宽，直接上代码：

TableColumn column = null;
for (int i = 0; i < 5; i++) {
    column = table.getColumnModel().getColumn(i);
    if (i == 2) {
        column.setPreferredWidth(100); //third column is bigger
    } else {
        column.setPreferredWidth(50);
    }
}

当你手动调整列宽时，其它列的宽度也会自动调整，因为窗体尺寸没变。

用户选择

与JList一样，JTable也支持三种选择模式：

• 单独选择：SINGLE_SELECTION
• 单重连续选择：SINGLE_INTERVAL_SELECTION
• 多重连续选择：MULTIPLE_INTERVAL_SELECTION

具体来说，你还可以设置是否允许选择行、选择列或选择单元格。需要注意的是，行、列选择与单元格选择会相互影响的。

1.在MULTIPLE_INTERVAL_SELECTION模式下：

选择单元格被永远禁止；选择行、选择列相互排斥，要么选择若干行，要么选择若干列；

2.在SINGLE_INTERVAL_SELECTION模式下：

禁止选择单元格时，选择行、选择列相互排斥，要么选择连续行，要么选择连续列。

启用选择单元格时，三者必须同时被选中，此时单元格可被单独或连续选中。

3.在SINGLE_SELECTION模式下：

禁止选择单元格时，选择行、选择列相互排斥，要么选择一行，要么选择一列。

启用选择单元格时，三者必须同时被选中，每次只能选择一个单元格。

注意，在JTable中无法同时选择独立的多个单元格，因为其Selection模型非常简单，就是取行与列的交集。

对于已选择的行、列的提取，使用JTable.getSelectedRows和JTable.getSelectedRows来提取它们的index。而lead selection的提取则有点违反直觉，代码如下：

String.format("Lead Selection: %d, %d. ",
    table.getSelectionModel().getLeadSelectionIndex(),
    table.getColumnModel().getSelectionModel().getLeadSelectionIndex());

监听数据变更

为了监听数据的变更，你需要调用model的addTableModelListener方法来添加一个监听器，而这个监听器必须实现了TableModelListener接口。该接口只有一个void tableChanged(TableModelEvent e)方法，你需要在里面进行响应。TableModelEvent将提供必要的信息，来指示发生变更的位置。它的方法有：

int getColumn()//Returns the column for the event.

int getFirstRow()//Returns the first row that changed.

int getLastRow()//Returns the last row that changed.

int getType()//Returns the type of event - one of: INSERT, UPDATE and DELETE.

得到位置后，你就可以调用model的getValueAt方法来获取最新值。

触发数据变更事件

为了触发数据变更事件，model必须知道如何创建数据变更事件。虽然这个过程很复杂，但是DefaultTableModel已经实现了。所以，你要么使用JTable默认的DefaultTableModel，要么自己继承DefaultTableModel。呐，如果你认为DefaultTableModel不合适而自己继承了 AbstractTableModel，那么你就得自己动动手啦！当数据被外部源改变时，你需要激活以下方法：

fireTableCellUpdated//Update of specified cell.

fireTableRowsUpdated//Update of specified rows

fireTableDataChanged//Update of entire table (data only).

fireTableRowsInserted//New rows inserted.

fireTableRowsDeleted//Existing rows Deleted

fireTableStructureChanged //Invalidate entire table, both data and structure.

渲染器与编辑器

渲染器决定了单元格内容的展现形式，而编辑器决定单元格内容被编辑的方式。比如，默认情况下，数字使用右对齐的JLabel来展示，布尔型变量使用单选控件来展示；而你在编辑某些列时，可能希望从下拉菜单中选择内容，这就是编辑器的作用了。出于性能上的考虑，JTable并没有为每一个单元格提供独立的渲染器，而是根据数据类型来渲染的。JTable首先会检查该列是否指定了渲染器，没有的话就检查该列的数据类型，并查看对应的渲染器。而基础类型以外的对象基本都是调用其toString方法，并通过JLable来渲染的。编辑器也是一样。

当然，我们可以对渲染器进行定制，来满足特定的需求。对指定的列或指定的数据类型应用定制渲染器都可以。如果是前者你需要调用JTable的setDefaultRenderer方法；如果是后者你需要调用指定列的setCellRenderer方法。如果你要为特定的单元格指定渲染器，那你需要调用继承JTable并重载getCellRenderer 方法。构造渲染器的最简单方法是继承DefaultTableCellRenderer类，然后实现它的setValue方法，你在里面使用setText或者setIcon来定制你渲染的内容。如果这还不够，那你可以继承一个已经存在的组件并实现 TableCellRenderer接口，比如让你的JLable继承这个接口，然后将它作为渲染器使用。

Table Render Demo Project是一个定制渲染器与编辑器的绝好例子，运行效果如下：

单元格提示（Tool tips for Cells）

单元格提示效果如上图，鼠标悬停时可显示出定制内容。在默认情况下，它是由单元格的渲染器决定的；然而，你也可以重载JTable的getToolTipText(MouseEvent)实现。下面分别介绍这两种方法。

（1）为单元格渲染器添加提示，首先需要建立一个渲染器，确认它是一个JComponent，然后用它调用setToolTipText即可。以下代码来自于TableRenderDemo.java：

//Set up tool tips for the sport cells.
DefaultTableCellRenderer renderer =
        new DefaultTableCellRenderer();
renderer.setToolTipText("Click for combo box");
sportColumn.setCellRenderer(renderer);

以下代码来自于 ColorRenderer.java：

public class ColorRenderer extends JLabel 
                           implements TableCellRenderer {
    ...
    public Component getTableCellRendererComponent(
                            JTable table, Object color,
                            boolean isSelected, boolean hasFocus,
                            int row, int column) {
        Color newColor = (Color)color;
        ...
        setToolTipText("RGB value: " + newColor.getRed() + ", "
                                     + newColor.getGreen() + ", "
                                     + newColor.getBlue());
        return this;
    }
}

（2）重载JTable的getToolTipText(MouseEvent)

在该方法中，找到指定列，然后返回指定的字符串。以下代码来自于TableToolTipsDemo.java：

JTable table = new JTable(new MyTableModel()) {    
    //Implement table cell tool tips.
    public String getToolTipText(MouseEvent e) {
        String tip = null;
        java.awt.Point p = e.getPoint();
        int rowIndex = rowAtPoint(p);
        int colIndex = columnAtPoint(p);
        int realColumnIndex = convertColumnIndexToModel(colIndex);

        if (realColumnIndex == 2) { //Sport column
            tip = "This person's favorite sport to "
                   + "participate in is: "
                   + getValueAt(rowIndex, colIndex);

        } else if (realColumnIndex == 4) { //Veggie column
            TableModel model = getModel();
            String firstName = (String)model.getValueAt(rowIndex,0);
            String lastName = (String)model.getValueAt(rowIndex,1);
            Boolean veggie = (Boolean)model.getValueAt(rowIndex,4);
            if (Boolean.TRUE.equals(veggie)) {
                tip = firstName + " " + lastName
                      + " is a vegetarian";
            } else {
                tip = firstName + " " + lastName
                      + " is not a vegetarian";
            }

        } else { //another column
            //You can omit this part if you know you don't 
            //have any renderers that supply their own tool 
            //tips.
            tip = super.getToolTipText(e);
        }
        return tip;
    }
    ...
}

运行效果如下图：

表头提示

通常表头中的不同列都具有不同的文字提示。你可以通过重载表头的getToolTipText方法来改变文字提示，也可以调用TableColumn.setHeaderRenderer来为表头提供一个定制的渲染器。

以下代码来自于TableSorterDemo.java，它为所有列头提供了相同的文字提示：

table.getTableHeader().setToolTipText(
        "Click to sort; Shift-Click to sort in reverse order");

以下代码来自于TableSorterDemo.java，它为后3列的列头提供不同的文字提示。

protected String[] columnToolTips = {
    null, // "First Name" assumed obvious
    null, // "Last Name" assumed obvious
    "The person's favorite sport to participate in",
    "The number of years the person has played the sport",
    "If checked, the person eats no meat"};
...

JTable table = new JTable(new MyTableModel()) {
    ...

    //Implement table header tool tips.
    protected JTableHeader createDefaultTableHeader() {
        return new JTableHeader(columnModel) {
            public String getToolTipText(MouseEvent e) {
                String tip = null;
                java.awt.Point p = e.getPoint();
                int index = columnModel.getColumnIndexAtX(p.x);
                int realIndex = 
                        columnModel.getColumn(index).getModelIndex();
                return columnToolTips[realIndex];
            }
        };
    }
};

运行效果如下：

排序和过滤