javax.swing
类 JTable

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JTable

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, CellEditorListener, ListSelectionListener, RowSorterListener, TableColumnModelListener, TableModelListener, Scrollable

public class JTable
     

      extends 
      JComponent
     
     

      implements 
      TableModelListener, 
      Scrollable, 
      TableColumnModelListener, 
      ListSelectionListener, 
      CellEditorListener, 
      Accessible, 
      RowSorterListener
     

JTable 用来显示和编辑常规二维单元表。有关面向任务的文档和使用 JTable 的示例，请参阅 The Java Tutorial 中的 How to Use Tables 一节。

JTable 有很多用来自定义其呈现和编辑的工具，同时提供了这些功能的默认设置，从而可以轻松地设置简单表。例如，要设置一个 10 行 10 列的表：

      TableModel dataModel = new AbstractTableModel() {
          public int getColumnCount() { return 10; }
          public int getRowCount() { return 10;}
          public Object getValueAt(int row, int col) { return new Integer(row*col); }
      };
      JTable table = new JTable(dataModel);
      JScrollPane scrollpane = new JScrollPane(table);
 

注意，如果要在单独的视图中（在 JScrollPane 外）使用 JTable 并显示表标题，则可以使用 getTableHeader() 获取并单独显示它。

要启用行的排序和过滤，请使用 RowSorter。可以通过以下两种方式之一设置一个行排序器。

• 直接设置 RowSorter。例如：table.setRowSorter(new TableRowSorter(model))。
• 将 autoCreateRowSorter 属性设置为 true，从而 JTable 可用于创建 RowSorter。例如：setAutoCreateRowSorter(true)。

设计使用 JTable 的应用程序时，务必要注意用来表示表数据的数据结构。DefaultTableModel 是一个模型实现，它使用一个 Vector 来存储所有单元格的值，该 Vector 由包含多个 Object 的 Vector 组成。除了将数据从应用程序复制到 DefaultTableModel 中之外，还可以用 TableModel 接口的方法来包装数据，这样可将数据直接传递到 JTable，如上例所示。这通常可以提高应用程序的效率，因为模型可以自由选择最适合数据的内部表示形式。在决定使用 AbstractTableModel 还是使用 DefaultTableModel 方面有一个好的实践经验，即在创建子类时使用 AbstractTableModel 作为基类，在不需要创建子类时则使用 DefaultTableModel。

源分布演示部分中的 "TableExample" 目录给出了许多 JTable 用法的完整示例，包括如何使用 JTable 来提供一个可编辑的数据视图（数据取自数据库），以及如何修改显示的列以使用指定的渲染器和编辑器。

JTable 使用专有的整数来引用它所显示的模型的行和列。JTable 采用表格的单元格范围，并在绘制时使用 getValueAt(int, int) 从模型中获取值。务必记住各种 JTable 方法所返回的列和行索引是就 JTable（视图）而言的，不一定是模型所使用的那些索引。

默认情况下，在 JTable 中对列进行重新安排，这样在视图中列的出现顺序与模型中列的顺序不同。但这根本不影响模型的实现：当列重新排列时，JTable 在内部保持列的新顺序，并在查询模型前转换其列索引。

因此编写 TableModel 时，不必侦听列的重排事件，因为不管视图怎样，模型都将在其自己的坐标系统被查询。在示例部分中有一个排序算法的演示，此演示正是使用了此技术在另一个坐标系统中进行排序，其中更改了行顺序，没有更改列顺序。

类似地，使用 RowSorter 提供的排序和过滤功能时，底层 TableModel 不需要知道怎样进行排序，RowSorter 将处理它。对底层 TableModel 使用 JTable 的基于行的方法时，必须进行坐标转换。所有基于 JTable 行的方法都是就 RowSorter 而言的，不一定与底层 TableModel 的方法相同。例如，选择始终是就 JTable 而言的，因此使用 RowSorter 时，需要使用 convertRowIndexToView 或 convertRowIndexToModel 进行转换。以下代码显示了如何将 JTable 的坐标转换为底层模型的坐标：

   int[] selection = table.getSelectedRows();
   for (int i = 0; i < selection.length; i++) {
     selection[i] = table.convertRowIndexToModel(selection[i]);
   }
   // selection is now in terms of the underlying TableModel
 

默认情况下，如果启用排序，那么排序时 JTable 将保留基于模型的选择和可变行高度。例如，如果当前选择行 0（就底层模型而言），那么排序之后将选择行 0（就底层模型而言）。选择有可能看起来被更改了，但就底层模型而言它仍然保持不变。模型索引不再可见或者被移除时除外。例如，如果行 0 被过滤掉了，那么选择在排序后将为空。

J2SE 5 在 JTable 中添加了一些方法，为某些普通打印需求提供方便的访问。print() 是一个简单的新方法，它允许快速简单地向应用程序添加打印支持。此外，新的 getPrintable(javax.swing.JTable.PrintMode, java.text.MessageFormat, java.text.MessageFormat) 方法可用于更高级的打印需求。

对于所有的 JComponent 类，可以使用 InputMap 和 ActionMap 将 Action 对象与 KeyStroke 进行关联，并在指定的条件下执行动作。

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

DefaultTableModel, TableRowSorter