【Java Swing】JTextFieldとJFormattedTextFieldの違いを徹底解説

Swingには、テキスト入力を受け付けるコンポーネントとして JTextField と JFormattedTextField の2種類があります。JTextField はプレーンなテキストをそのまま入力するためのものである一方、JFormattedTextField は JTextField を継承したクラスで、電話番号・メールアドレス・日付などの特定の書式（フォーマット）を入力内容に適用できる点が大きな特徴です。

JTextFieldとは

• JTextField は、ユーザーが1行のテキストを入力できる、Swingの中でも最も重要なコンポーネントの一つです。
• テキストフィールド内に入力を行うと ActionListener インターフェースが発生し、キャレット（いわゆるカーソル）の位置が変化するたびに CaretListener インターフェースが発生します。
• また、MouseListener や KeyListener といったインターフェースにも対応しており、マウス操作やキー入力に対する柔軟なイベント処理が可能です。

JTextFieldのサンプルコード

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
public class JTextFieldTest extends JFrame {
    JTextField jtf;
    public JTextFieldTest() {
        setTitle("JTextField Test");
        setLayout(new FlowLayout());
        jtf = new JTextField(15);
        add(jtf);
        jtf.addActionListener(new ActionListener() {
            public void actionPerformed (ActionEvent ae) {
                System.out.println("Event generated: " + jtf.getText());
            }
        });
        setSize(375, 250);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setLocationRelativeTo(null);
        setVisible(true);
    }
    public static void main(String args[]) {
        new JTextFieldTest();
    }
}

実行結果

JFormattedTextFieldとは

• フォーマット付きテキストフィールドは、JTextField の直接のサブクラスである JFormattedTextField クラスのインスタンスとして作成します。
• JFormattedTextField は見た目こそ通常のテキストフィールドとほぼ同じですが、ユーザーが入力する文字の有効性（妥当性）を制御できる点が異なります。入力可能な文字を定義した フォーマッター を関連付けることで、誤った形式の入力を防ぐことができます。
• JFormattedTextField は Formatクラス をベースにフォーマット付きテキストフィールドを構築します。まずフォーマッターを作成し、必要に応じてカスタマイズした上で、Format 型の引数を受け取る JFormattedTextField(Format format) コンストラクタを呼び出して利用します。

JFormattedTextFieldのサンプルコード

import java.awt.*;
import javax.swing.*;
import javax.swing.text.*;
public class JFormattedTextFieldTest extends JFrame {
    JFormattedTextField jftf;
    MaskFormatter mf;
    public JFormattedTextFieldTest() {
        setTitle("JFormattedTextField Test");
        setLayout(new FlowLayout());
        // 電話番号用のフォーマッター - (国コード)-(市外局番)-(番号)
        try {
            mf = new MaskFormatter("##-###-#######");
            mf.setPlaceholderCharacter('#');
            jftf = new JFormattedTextField(mf);
            jftf.setColumns(12);
        } catch(Exception e) {
            e.printStackTrace();
        }
        add(jftf);
        setSize(375, 250);
        setLocationRelativeTo(null);
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setVisible(true);
    }
    public static void main(String args[]) {
        new JFormattedTextFieldTest();
    }
}

実行結果

このように、単純な自由入力なら JTextField、郵便番号や電話番号、日付など決まった書式での入力を強制したい場合には JFormattedTextField（MaskFormatter との組み合わせ）を使い分けることで、より使いやすく堅牢なGUIアプリケーションを構築できます。