JTableマスターへの道：javax.swing.table徹底解説

JavaでGUIアプリケーションを開発する際、表形式のデータを扱う場面は非常に多くあります。そのような状況で絶大な力を発揮するのが、Java Swingライブラリに含まれる`javax.swing.table`パッケージ、その中でも中核をなす`JTable`コンポーネントです。

`JTable`は、単にデータを格子状に表示するだけでなく、ユーザーによるデータの編集、ソート、フィルタリングなど、高機能な表計算ソフトのようなインタラクティブな機能を提供します。SwingはJavaの標準ライブラリの一部であり、長年にわたり多くのデスクトップアプリケーション開発で利用されてきた実績があります。JavaFXのような後継技術も登場していますが、既存の多くのシステムで今なお現役で稼働しており、その知識は依然として価値があります。

この記事では、`JTable`の基本的な使い方から、その能力を最大限に引き出すためのカスタマイズ方法まで、段階的かつ網羅的に解説していきます。

何事もまずは基本から。`JTable`を画面に表示させる最も簡単な方法を見ていきましょう。`JTable`のコンストラクタにはいくつかの種類がありますが、ここでは表示するデータと列見出しを直接指定する方法を紹介します。

データは2次元配列（`Object[][]`）、列見出しは1次元配列（`Object[]`）で用意するのが一般的です。

import javax.swing.*;
import java.awt.*;
public class BasicJTableExample extends JFrame { public BasicJTableExample() { setTitle("基本的なJTableの例"); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setSize(500, 300); setLocationRelativeTo(null); // 1. 表示するデータ (2次元配列) Object[][] data = { {"1", "Taro Yamada", "Tokyo", 30}, {"2", "Hanako Suzuki", "Osaka", 25}, {"3", "Jiro Tanaka", "Nagoya", 35}, {"4", "Sachiko Kato", "Fukuoka", 28}, {"5", "Ichiro Yamamoto", "Sapporo", 42} }; // 2. 列の見出し (1次元配列) String[] columnNames = {"ID", "名前", "出身地", "年齢"}; // 3. JTableのインスタンスを生成 JTable table = new JTable(data, columnNames); // 4. JTableをJScrollPaneに追加 JScrollPane scrollPane = new JScrollPane(table); // 5. JScrollPaneをフレームに追加 add(scrollPane, BorderLayout.CENTER); } public static void main(String[] args) { SwingUtilities.invokeLater(() -> { BasicJTableExample example = new BasicJTableExample(); example.setVisible(true); }); }
} 

このコードを実行すると、指定したデータと列見出しを持つシンプルなテーブルがウィンドウに表示されます。非常に直感的で簡単であることがわかります。しかし、この方法ではデータの追加や削除といった動的な操作が困難です。そこで次に、データ管理の核心である`TableModel`について学びます。

Swingのコンポーネントは、MVC（Model-View-Controller）アーキテクチャに似た設計思想で作られています。`JTable`も例外ではなく、見た目（View）を担当する`JTable`オブジェクトと、データそのもの（Model）を担当する`TableModel`オブジェクトが分離されています。

この分離により、データの管理ロジックと表示ロジックを独立して扱うことができ、より柔軟でメンテナンス性の高いコードを書くことが可能になります。`TableModel`はインタフェースであり、Swingではその便利な実装クラスとして`DefaultTableModel`が提供されています。

DefaultTableModelの活用

`DefaultTableModel`は、テーブルのデータを内部的に`Vector`で管理し、行の追加、削除、値の変更といった操作を簡単に行うためのメソッドを提供します。

`DefaultTableModel`を使って、ボタン操作で動的に行を追加・削除するサンプルコードを見てみましょう。

import javax.swing.*;
import javax.swing.table.DefaultTableModel;
import java.awt.*;
public class DynamicJTableExample extends JFrame { private DefaultTableModel tableModel; private JTable table; private int newId = 6; public DynamicJTableExample() { setTitle("動的なJTableの例"); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setSize(600, 400); setLocationRelativeTo(null); String[] columnNames = {"ID", "名前", "出身地", "年齢"}; // 最初は空のデータモデルを作成 tableModel = new DefaultTableModel(null, columnNames); // JTableにモデルを設定 table = new JTable(tableModel); // 初期データをモデルに追加 addInitialData(); JScrollPane scrollPane = new JScrollPane(table); add(scrollPane, BorderLayout.CENTER); // 操作用パネル JPanel controlPanel = new JPanel(); JButton addButton = new JButton("行を追加"); JButton removeButton = new JButton("選択行を削除"); controlPanel.add(addButton); controlPanel.add(removeButton); add(controlPanel, BorderLayout.SOUTH); // --- イベントリスナーの設定 --- addButton.addActionListener(e -> { // 新しい行のデータを生成 Object[] newRow = {String.valueOf(newId++), "New User", "Unknown", (int)(Math.random() * 50)}; tableModel.addRow(newRow); }); removeButton.addActionListener(e -> { int selectedRow = table.getSelectedRow(); if (selectedRow != -1) { // Viewの行インデックスをModelの行インデックスに変換 int modelRow = table.convertRowIndexToModel(selectedRow); tableModel.removeRow(modelRow); } else { JOptionPane.showMessageDialog(this, "削除する行を選択してください。"); } }); } private void addInitialData() { Object[][] data = { {"1", "Taro Yamada", "Tokyo", 30}, {"2", "Hanako Suzuki", "Osaka", 25}, {"3", "Jiro Tanaka", "Nagoya", 35}, {"4", "Sachiko Kato", "Fukuoka", 28}, {"5", "Ichiro Yamamoto", "Sapporo", 42} }; for (Object[] rowData : data) { tableModel.addRow(rowData); } } public static void main(String[] args) { SwingUtilities.invokeLater(() -> { DynamicJTableExample example = new DynamicJTableExample(); example.setVisible(true); }); }
} 

この例では、`JTable`に直接データを渡すのではなく、`DefaultTableModel`のインスタンスを作成し、それを`JTable`のコンストラクタに渡しています。ボタンのアクションでは`JTable`を直接操作するのではなく、`tableModel`のメソッドを呼び出している点に注目してください。モデルのデータが変更されると、`JTable`は自動的にその変更を検知して表示を更新します。

インタラクティブなアプリケーションを作成するには、ユーザーのアクションを検知する必要があります。`JTable`では主に2種類のイベントが重要になります。

1. 行選択イベント (`ListSelectionListener`): ユーザーがどの行を選択したかを検知します。
2. データ変更イベント (`TableModelListener`): ユーザーがセルの値を編集するなどして、テーブルのデータが変更されたことを検知します。

ListSelectionListenerによる行選択の検知

`JTable`の選択状態を管理しているのは`ListSelectionModel`です。このモデルに`ListSelectionListener`を追加することで、選択行の変更イベントを受け取ることができます。

// JTableのListSelectionModelを取得してリスナーを追加
ListSelectionModel selectionModel = table.getSelectionModel();
selectionModel.addListSelectionListener(e -> { // valueIsAdjustingは選択操作の途中（ドラッグ中など）でも発火するため、 // 操作が完了したタイミングのみ処理を実行するようにする if (!e.getValueIsAdjusting()) { int selectedRow = table.getSelectedRow(); if (selectedRow != -1) { // 選択された行のデータを取得 int modelRow = table.convertRowIndexToModel(selectedRow); String id = (String) tableModel.getValueAt(modelRow, 0); String name = (String) tableModel.getValueAt(modelRow, 1); System.out.println("選択された行: " + selectedRow + ", ID: " + id + ", 名前: " + name); } }
}); 

TableModelListenerによるデータ変更の検知

`TableModel`に`TableModelListener`を追加すると、セルの値が変更された、行が追加された、などのデータモデルの変更を検知できます。

// TableModelにリスナーを追加
tableModel.addTableModelListener(e -> { int row = e.getFirstRow(); int column = e.getColumn(); int type = e.getType(); // UPDATE, INSERT, DELETE のいずれか if (type == TableModelEvent.UPDATE) { Object data = tableModel.getValueAt(row, column); System.out.println("セル(" + row + ", " + column + ") が値 '" + data + "' に更新されました。"); }
}); 

これらのイベントリスナーを適切に組み合わせることで、ユーザーの操作に応じた詳細な処理を実装できます。例えば、行を選択したらその詳細情報を別のパネルに表示したり、セルが編集されたらデータベースに即座に反映したりといったことが可能です。

`JTable`の強力な機能の一つが、セルの描画方法を自由にカスタマイズできる`TableCellRenderer`です。`TableCellRenderer`は、各セルの値をどのように画面上に表示するかを定義するインターフェースです。

例えば、「数値がマイナスなら赤字にする」「特定の文字列なら背景色を変える」「真偽値をチェックボックスとして表示する」といった、複雑な要件にも対応できます。

`TableCellRenderer`を作成するには、`TableCellRenderer`インターフェースを実装します。しかし、多くの場合、`JLabel`を継承した`DefaultTableCellRenderer`を拡張する方が簡単です。

条件によるセルの色分け

年齢が40歳以上なら背景をオレンジ色に、30歳未満なら文字を青色にするカスタムレンダラーを作成してみましょう。

import javax.swing.*;
import javax.swing.table.DefaultTableCellRenderer;
import java.awt.*;
public class AgeCellRenderer extends DefaultTableCellRenderer { @Override 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); // valueはObject型なので、Integerにキャストする if (value instanceof Integer) { int age = (Integer) value; if (age >= 40) { c.setBackground(Color.ORANGE); c.setForeground(Color.BLACK); } else if (age < 30) { c.setBackground(isSelected ? table.getSelectionBackground() : table.getBackground()); c.setForeground(Color.BLUE); } else { // デフォルトの色に戻す c.setBackground(isSelected ? table.getSelectionBackground() : table.getBackground()); c.setForeground(isSelected ? table.getSelectionForeground() : table.getForeground()); } } return c; }
} 

このカスタムレンダラーを作成したら、特定の列に適用します。

// JTableのインスタンスがある前提
JTable table = new JTable(tableModel);
// 4列目（年齢の列）にカスタムレンダラーを設定
int ageColumnIndex = 3;
table.getColumnModel().getColumn(ageColumnIndex).setCellRenderer(new AgeCellRenderer()); 

`getTableCellRendererComponent`メソッドは、テーブルが再描画されるたびに各セルに対して呼び出されます。このメソッド内で、渡された値（`value`）や行・列番号（`row`, `column`）に応じて、コンポーネントのプロパティ（背景色、前景色、フォントなど）を変更し、そのコンポーネントを返すことで、セルの見た目をカスタマイズします。

デフォルトでは、`JTable`のセルをダブルクリックすると`JTextField`が表示され、テキスト編集が可能になります。しかし、常にテキスト入力が最適とは限りません。例えば、性別を入力する列では「男性」「女性」から選ばせたい、あるいはステータス列ではドロップダウンリストから選択させたい、といったケースがあります。

このようなセルの編集コンポーネントをカスタマイズするのが`TableCellEditor`です。`TableCellRenderer`が見た目を担当するのに対し、`TableCellEditor`は編集機能を担当します。

JComboBoxをセルエディタとして使用する

出身地の列を、あらかじめ定義された選択肢を持つ`JComboBox`で編集できるようにしてみましょう。`DefaultCellEditor`クラスを使えば、`JComboBox`, `JCheckBox`, `JTextField`を簡単にセルエディタとして設定できます。

// JTableのインスタンスがある前提
JTable table = new JTable(tableModel);
// 3列目（出身地の列）にJComboBoxをエディタとして設定
int locationColumnIndex = 2;
TableColumn locationColumn = table.getColumnModel().getColumn(locationColumnIndex);
// JComboBoxに表示する選択肢を定義
String[] locations = {"Tokyo", "Osaka", "Nagoya", "Fukuoka", "Sapporo", "Okinawa"};
JComboBox<String> comboBox = new JComboBox<>(locations);
// DefaultCellEditorを使ってJComboBoxをセルエディタに設定
locationColumn.setCellEditor(new DefaultCellEditor(comboBox)); 

この設定を行うと、出身地の列のセルを編集しようとすると（ダブルクリックなどで）、テキストフィールドの代わりに`JComboBox`が表示され、ユーザーはリストから地名を選択できるようになります。

より複雑なエディタを作成したい場合は、`AbstractCellEditor`クラスを継承して独自の`TableCellEditor`を実装することも可能です。これにより、例えば日付選択用のカレンダーコンポーネントをエディタとして組み込むなど、非常に高度なカスタマイズが実現できます。

扱うデータが多くなると、特定の条件でデータを並べ替えたり（ソート）、絞り込んだり（フィルタリング）する機能が不可欠になります。`JTable`では、`TableRowSorter`クラスを利用することで、これらの機能を驚くほど簡単に追加できます。

ソート機能の追加

`JTable`にソート機能を追加するのは非常に簡単です。`TableRowSorter`のインスタンスを作成し、`JTable`にセットするだけです。

// TableModelのインスタンスがある前提
DefaultTableModel tableModel = new DefaultTableModel(data, columnNames);
JTable table = new JTable(tableModel);
// TableRowSorterを作成し、テーブルに設定
TableRowSorter<DefaultTableModel> sorter = new TableRowSorter<>(tableModel);
table.setRowSorter(sorter); 

たったこれだけのコードで、ユーザーは列のヘッダーをクリックして昇順・降順にデータを並べ替えることができるようになります。Shiftキーを押しながら他のヘッダーをクリックすれば、複数列でのソートも可能です。

フィルタリング機能の実装

`TableRowSorter`は、`RowFilter`クラスと連携してフィルタリング機能も提供します。`RowFilter`は、どの行を表示するかを決定するための条件を定義します。

ここでは、テキストフィールドに入力された文字列を含む行だけを表示する、簡単な検索フィルターを実装してみましょう。

// 上記のソーターが設定されている前提
// ...
JTextField filterTextField = new JTextField(20);
JButton filterButton = new JButton("フィルター");
// パネルに配置
JPanel filterPanel = new JPanel();
filterPanel.add(new JLabel("検索文字列:"));
filterPanel.add(filterTextField);
filterPanel.add(filterButton);
// このパネルをフレームのどこかに追加する (例: NORTH)
add(filterPanel, BorderLayout.NORTH);
filterButton.addActionListener(e -> { String text = filterTextField.getText(); if (text.trim().length() == 0) { // テキストが空ならフィルターを解除 sorter.setRowFilter(null); } else { // 大文字・小文字を区別しない正規表現フィルターを設定 try { sorter.setRowFilter(RowFilter.regexFilter("(?i)" + text)); } catch (java.util.regex.PatternSyntaxException ex) { // 正規表現が無効な場合のエラーハンドリング JOptionPane.showMessageDialog(this, "無効な正規表現です。", "エラー", JOptionPane.ERROR_MESSAGE); } }
}); 

この例では、`RowFilter.regexFilter`を使用して、正規表現による強力なフィルタリングを実現しています。`(?i)`は、大文字と小文字を区別しないことを示す正規表現のフラグです。これにより、ユーザーは柔軟な検索を行うことができます。

`RowFilter`には、数値の大小比較（`numberFilter`）や複数のフィルタを組み合わせる（`andFilter`, `orFilter`）など、様々な静的メソッドが用意されており、複雑な絞り込み条件も簡単に構築できます。

この記事では、Java Swingの`javax.swing.table`パッケージ、特に`JTable`コンポーネントについて、その基本的な使い方から高度なカスタマイズ方法までを包括的に解説しました。

単純な表の作成から始まり、`DefaultTableModel`による動的なデータ操作、イベントリスナーによるインタラクションの実装、そして`TableCellRenderer`と`TableCellEditor`による見た目と編集機能の完全な制御、最後に`TableRowSorter`を用いた強力なソート・フィルタリング機能まで、`JTable`が持つ柔軟性と強力さを理解いただけたかと思います。

`JTable`を使いこなすことは、Javaで高機能なデスクトップアプリケーションを開発する上で非常に強力な武器となります。ここに記載された知識をベースに、さらに探求することで、あらゆるデータ表示の要求に応えられるようになるでしょう。