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 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]; } }; } };
运行效果如下：
排序和过滤
