JavaのJTableでレコードが存在しない場合に「No records available」テキストを表示する方法

JTableとは

JTableはJComponentクラスのサブクラスであり、情報を複数の行（row）と列（column）に分けて表示するテーブルを作成するために使用されます。JTable上で値を選択すると、TableModelEventが生成され、このイベントはTableModelListenerインターフェースを実装することで処理できます。

以下のプログラムでは、JTableに行データが存在しない場合に、「No records available」というテキストを表示する方法を紹介します。

実装例

ポイントは、空のデータ配列を持つJTableに対して、JLabelを直接追加し、setFillsViewportHeight(true)を呼び出してビューポート全体を埋めることです。これにより、レコードがない領域にもメッセージが表示されるようになります。

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import javax.swing.table.*;

public class NoRecordTableTest extends JFrame {
    private JPanel panel;
    private JTable table;
    private JScrollPane scrollPane;

    public NoRecordTableTest() {
        panel = new JPanel();
        panel.setLayout(new BorderLayout());
        String columnNames[] = {"Column 1", "Column 2", "Column 3"};
        String dataValues[][] = {};
        table = new JTable(dataValues, columnNames);
        JLabel label = new JLabel("No records available");
        label.setSize(label.getPreferredSize());
        table.add(label);
        table.setFillsViewportHeight(true);
        scrollPane = new JScrollPane(table);
        panel.add(scrollPane, BorderLayout.CENTER);
        panel.add(new Label("No records available"), BorderLayout.SOUTH);
        add(panel);
        setSize(400, 300);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setLocationRelativeTo(null);
        setVisible(true);
    }

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

コードの解説

• 空のデータ配列：String dataValues[][] = {}; により、行データが存在しない状態のテーブルを作成します。
• JLabelの追加：テーブルコンポーネント自体に「No records available」というラベルを追加することで、空の領域にメッセージを表示できます。
• setFillsViewportHeight(true)：テーブルがビューポートの高さいっぱいに広がるため、レコードがない部分にもラベルが見えるようになります。
• BorderLayoutの活用：下部（SOUTH）にも同じメッセージを配置し、ユーザーにデータがないことを明確に伝えています。

実行結果

このプログラムを実行すると、列ヘッダーのみが表示され、テーブルの中央付近には「No records available」のテキストが表示されます。ウィンドウ下部にも同様のメッセージが表示され、データが存在しないことが一目でわかります。

この手法は、検索結果が空の場合やデータベースから取得したレコードがゼロ件の場合など、ユーザーに状態を分かりやすく伝えたい場面で非常に有効です。