JavaでJTextFieldに数値のみ入力できるようにする方法

JTextFieldの入力制限とは

デフォルトのJTextFieldは、数値・文字・特殊文字など、あらゆる種類の入力を受け付けることができます。しかし、ユーザーがJTextFieldに入力した内容を検証するのは意外と難しく、特にintなどの数値型へ変換する必要がある場合は注意が必要です。

本記事では、JTextFieldに数値のみ入力できるように制限する方法を、具体的なサンプルコードとともに解説します。

実装のポイント

キー入力を監視するためにKeyListener（KeyAdapter）を使用し、押されたキーの文字が「0」から「9」の範囲内であるかどうかを判定します。数値であれば編集を許可し、それ以外の場合は編集を無効化して警告メッセージを表示します。

サンプルコード

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

public class JTextFieldValidation extends JFrame {
    JTextField tf;
    Container container;
    JLabel label;

    public JTextFieldValidation() {
        container = getContentPane();
        setBounds(0, 0, 500, 300);
        tf = new JTextField(25);
        setLayout(new FlowLayout());
        container.add(new JLabel("Enter the number"));
        container.add(tf);
        container.add(label = new JLabel());
        label.setForeground(Color.red);
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setLocationRelativeTo(null);

        tf.addKeyListener(new KeyAdapter() {
            public void keyPressed(KeyEvent ke) {
                String value = tf.getText();
                int l = value.length();
                if (ke.getKeyChar() >= '0' && ke.getKeyChar() <= '9') {
                    tf.setEditable(true);
                    label.setText("");
                } else {
                    tf.setEditable(false);
                    label.setText("* Enter only numeric digits(0-9)");
                }
            }
        });
        setVisible(true);
    }

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

コードの解説

• KeyAdapterの利用：KeyListenerインターフェースを実装すると不要なメソッドも定義する必要がありますが、KeyAdapterクラスを継承すれば必要なメソッドだけをオーバーライドできます。
• keyPressedメソッド：キーが押されるたびに呼び出され、getKeyChar()で取得した文字が「0〜9」の範囲にあるかをチェックします。
• setEditable(true/false)：数値以外のキーが押された場合はテキストフィールドの編集を一時的に無効化し、不正な入力を防ぎます。
• エラーメッセージの表示：赤色のJLabelを使って「0〜9の数字のみ入力してください」という警告をユーザーに伝えます。

実行結果

このプログラムを実行すると、テキストフィールドには数字（0〜9）のみ入力可能になります。英字や記号を入力しようとすると、画面上に赤い警告メッセージが表示され、入力が拒否されます。

補足：より堅牢な代替手段

KeyListenerによる制御はシンプルですが、貼り付け（ペースト）操作までは防げないという弱点があります。より厳密に入力を制御したい場合は、DocumentFilterやJFormattedTextField、あるいはInputVerifierを使用する方法も検討するとよいでしょう。これらを活用すれば、ペーストされた文字列に対しても確実にバリデーションを行えます。