JavaTable：可編輯表格數據可視化組件

一、介紹

JavaTable是一種可編輯表格數據可視化組件，提供分頁、排序、搜索、過濾和編輯等強大的數據交互功能。這個組件能夠輕易地嵌入任何Java Swing應用程序中，幫助用戶以最可視化的方式展示和編輯大量數據。

二、特點

JavaTable有以下特點：

• 支持各種數據類型，如整數、浮點數、文本、日期、下拉菜單等；
• 能夠自定義單元格的渲染和編輯器，以適應不同的應用場景；
• 支持列頭和行頭的固定，方便查看大量數據；
• 支持多級排序，能夠按多個字段排序數據；
• 支持查找和替換功能，能夠高效地找到和修改數據；
• 支持過濾功能，能夠根據條件過濾數據；
• 支持導出數據為Excel、CSV等格式，方便數據分析和交換；
• 支持通過拖拽等方式快速編輯數據；
• 支持數據校驗，能夠確保數據的正確性。

三、組件使用

以下是JavaTable組件的使用方法：

1. 創建JavaTable實例

  // 創建JavaTable實例
  JavaTable table = new JavaTable(data, columns);
  
  // 添加JavaTable到容器中
  JScrollPane scroll = new JScrollPane(table);
  frame.add(scroll);

其中，data是二維數組，表示表格中的數據，columns是一維數組，表示表格中的列。

2. 自定義單元格渲染和編輯器

JavaTable默認使用默認渲染器和編輯器來渲染和編輯單元格。如果需要自定義渲染器和編輯器，可以覆蓋相應的方法，如下所示：

// 自定義單元格渲染器
public class MyRenderer extends DefaultTableCellRenderer {
  public Component getTableCellRendererComponent(
      JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) {
    Component c = super.getTableCellRendererComponent(table, value, isSelected, hasFocus, row, column);
    // 自定義渲染器代碼
    return c;
  }
}

// 自定義單元格編輯器
public class MyEditor extends DefaultCellEditor {
  public MyEditor() {
    super(new JTextField());
  }
  public Component getTableCellEditorComponent(
      JTable table, Object value, boolean isSelected, int row, int column) {
    Component c = super.getTableCellEditorComponent(table, value, isSelected, row, column);
    // 自定義編輯器代碼
    return c;
  }
}

// 應用自定義渲染器和編輯器
table.setDefaultRenderer(Integer.class, new MyRenderer());
table.setDefaultEditor(String.class, new MyEditor());

3. 事件處理

JavaTable支持各種鼠標和鍵盤事件，如單擊、雙擊、按鍵等。可以通過添加事件監聽器來處理這些事件，如下所示：

table.addMouseListener(new MouseAdapter() {
  public void mouseClicked(MouseEvent e) {
    // 處理鼠標單擊事件
  }
});
table.addKeyListener(new KeyAdapter() {
  public void keyPressed(KeyEvent e) {
    // 處理鍵盤按鍵事件
  }
});

4. 分頁、排序、查找和過濾

JavaTable提供分頁、排序、查找和過濾功能，可以通過以下方法來激活這些功能：

// 分頁
table.setPageSize(10); // 每頁顯示10行數據
table.setPage(1); // 顯示第一頁數據

// 排序
table.setSortable(true); // 開啟排序功能
table.setSortOrder(1, SortOrder.DESCENDING); // 按第1列進行降序排列

// 查找
table.setSearchable(true); // 開啟查找功能
table.search("keyword"); // 查找包含"keyword"的數據

// 過濾
table.setFilterable(true); // 開啟過濾功能
table.setFilter(1, new MyFilter()); // 使用自定義過濾器過濾第1列數據

四、示例代碼

以下是一個JavaTable的完整示例代碼：

import java.awt.Component;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.awt.event.KeyAdapter;
import java.awt.event.KeyEvent;
import javax.swing.*;
import javax.swing.table.DefaultTableCellRenderer;
import javax.swing.table.TableCellEditor;
import javax.swing.table.TableCellRenderer;
import javax.swing.table.TableColumnModel;

public class JavaTableExample extends JFrame {

  public JavaTableExample() {
    // 創建JavaTable實例
    String[] columns = {"序號", "姓名", "年齡", "性別"};
    Object[][] data = {
        {1, "張三", 28, "男"},
        {2, "李四", 30, "女"},
        {3, "王五", 25, "男"}
    };
    JavaTable table = new JavaTable(data, columns);

    // 添加JavaTable到容器中
    JScrollPane scroll = new JScrollPane(table);
    add(scroll);

    // 自定義單元格渲染器
    table.setDefaultRenderer(Integer.class, new MyRenderer());

    // 自定義單元格編輯器
    table.setDefaultEditor(String.class, new MyEditor());

    // 添加單擊事件處理
    table.addMouseListener(new MouseAdapter() {
      public void mouseClicked(MouseEvent e) {
        int row = table.getSelectedRow();
        int col = table.getSelectedColumn();
        Object value = table.getValueAt(row, col);
        System.out.println("cell value: " + value);
      }
    });

    // 添加鍵盤事件處理
    table.addKeyListener(new KeyAdapter() {
      public void keyPressed(KeyEvent e) {
        if (e.getKeyCode() == KeyEvent.VK_ENTER) {
          int row = table.getSelectedRow();
          int col = table.getSelectedColumn();
          Object value = table.getValueAt(row, col);
          System.out.println("cell value: " + value);
        }
      }
    });

    // 分頁
    table.setPageSize(2); // 每頁顯示2條數據
    table.setPage(1); // 顯示第1頁數據

    // 排序
    table.setSortable(true); // 開啟排序功能
    table.setSortOrder(2, SortOrder.ASCENDING); // 按第2列進行升序排列

    // 查找
    table.setSearchable(true); // 開啟查找功能
    table.search("李四"); // 查找包含"李四"的數據

    // 過濾
    table.setFilterable(true); // 開啟過濾功能
    table.setFilter(3, new GenderFilter("女")); // 過濾性別為"女"的數據

    // 設置表格列寬自適應
    TableColumnModel cm = table.getColumnModel();
    for (int i = 0; i < cm.getColumnCount(); i++) {
      cm.getColumn(i).setPreferredWidth(100);
    }

    setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    setLocationRelativeTo(null);
    setSize(500, 300);
    setVisible(true);
  }

  class MyRenderer extends DefaultTableCellRenderer {
    public Component getTableCellRendererComponent(
        JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) {
      Component c = super.getTableCellRendererComponent(table, value, isSelected, hasFocus, row, column);
      // 自定義渲染器代碼
      return c;
    }
  }

  class MyEditor extends DefaultCellEditor {
    public MyEditor() {
      super(new JTextField());
    }
    public Component getTableCellEditorComponent(
        JTable table, Object value, boolean isSelected, int row, int column) {
      Component c = super.getTableCellEditorComponent(table, value, isSelected, row, column);
      // 自定義編輯器代碼
      return c;
    }
  }

  class GenderFilter implements JavaTable.Filter {
    private String gender;
    public GenderFilter(String gender) {
      this.gender = gender;
    }
    public boolean accept(Object value) {
      if (value == null) return false;
      return value.toString().equals(gender);
    }
  }

  public static void main(String[] args) {
    new JavaTableExample();
  }
}