Java Swing 桌面应用

在 Swing 中，你可以通过以下几种方法来限制 JTextField 只能输入数字。

使用 DocumentFilter (最推荐、最灵活)

这是最标准、最灵活的方法，它允许你精确地控制文本框中的内容，不仅限制输入，还可以限制长度、格式等。

实现步骤：

1. 创建一个继承自 PlainDocument 的自定义文档类。
2. 在这个自定义文档类中重写 insertString 和 remove 方法，在其中添加你的逻辑判断。
3. 将这个自定义文档设置给你的 JTextField。

代码示例：

import javax.swing.*;
import javax.swing.text.*;
import java.awt.*;
public class NumericTextFieldExample {
    public static void main(String[] args) {
        // 创建窗口
        JFrame frame = new JFrame("只能输入数字的文本框");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 150);
        frame.setLayout(new FlowLayout());
        // 创建一个普通的文本框
        JTextField textField = new JTextField(15);
        // 使用我们的自定义文档
        textField.setDocument(new NumericDocument());
        // 添加一个标签
        JLabel label = new JLabel("请输入数字:");
        // 将组件添加到窗口
        frame.add(label);
        frame.add(textField);
        // 显示窗口
        frame.setVisible(true);
    }
}
/**
 * 自定义文档，用于限制只能输入数字
 */
class NumericDocument extends PlainDocument {
    @Override
    public void insertString(int offset, String str, AttributeSet attr) throws BadLocationException {
        // 如果插入的字符串为空，则直接返回
        if (str == null) {
            return;
        }
        // 检查插入的字符串是否全部由数字组成
        if (str.matches("\\d+")) {
            // 如果是数字，则允许插入
            super.insertString(offset, str, attr);
        }
        // 如果不是数字，则忽略此次输入
    }
    @Override
    public void remove(int offset, int length) throws BadLocationException {
        // 允许删除操作
        super.remove(offset, length);
    }
}

优点：

• 灵活：可以轻松扩展，例如限制小数点、限制长度等。
• 健壮：直接作用于数据模型，非常可靠。
• 标准做法：是 Swing 中处理文本输入限制的推荐方式。

使用 InputVerifier (适用于验证)

InputVerifier 主要用于在组件失去焦点时验证其内容，它不能阻止用户输入非数字字符，但可以在用户输入完成后给出提示并阻止焦点离开。

代码示例：

import javax.swing.*;
import java.awt.*;
public class InputVerifierExample {
    public static void main(String[] args) {
        JFrame frame = new JFrame("InputVerifier 示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 150);
        frame.setLayout(new FlowLayout());
        JTextField textField = new JTextField(15);
        // 设置输入验证器
        textField.setInputVerifier(new NumericInputVerifier());
        JLabel label = new JLabel("请输入数字 (离开文本框时验证):");
        JButton button = new JButton("下一个焦点"); // 用于测试
        frame.add(label);
        frame.add(textField);
        frame.add(button);
        frame.setVisible(true);
    }
}
/**
 * 自定义输入验证器
 */
class NumericInputVerifier extends InputVerifier {
    @Override
    public boolean verify(JComponent input) {
        JTextField textField = (JTextField) input;
        String text = textField.getText();
        // 如果文本框为空，通常认为是合法的
        if (text.isEmpty()) {
            return true;
        }
        try {
            // 尝试将文本解析为数字
            Double.parseDouble(text);
            return true; // 解析成功，内容合法
        } catch (NumberFormatException e) {
            // 解析失败，内容不合法
            JOptionPane.showMessageDialog(input, "请输入有效的数字！", "输入错误", JOptionPane.ERROR_MESSAGE);
            return false; // 阻止焦点离开
        }
    }
}

优点：

• 适合在表单提交前进行数据校验。
• 可以提供友好的错误提示。

缺点：

• 不能阻止输入：用户仍然可以输入字母，只是在尝试离开时会被阻止。

使用 KeyListener (不推荐，但简单)

通过监听键盘事件来判断按键是否为数字,这种方法比较“暴力”，且处理复杂（如需要处理粘贴、组合键等），不推荐使用，但作为基础了解可以。

// 在JTextField上添加Key Listener
textField.addKeyListener(new KeyAdapter() {
    @Override
    public void keyTyped(KeyEvent e) {
        char c = e.getKeyChar();
        // 如果按下的不是数字，也不是退格键、删除键、方向键等控制键，则消费掉该事件
        if (!Character.isDigit(c) && 
            c != KeyEvent.VK_BACK_SPACE && 
            c != KeyEvent.VK_DELETE && 
            c != KeyEvent.VK_ENTER &&
            c != KeyEvent.VK_TAB) {
            e.consume(); // 阻止事件继续传播
        }
    }
});

缺点：

• 不完整：无法处理通过鼠标粘贴或拖放的非数字内容。
• 代码冗余：需要处理很多特殊情况，代码不够优雅。

JavaFX 桌面应用

JavaFX 的实现方式更现代化，通常使用 TextFormatter。

代码示例：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.TextField;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;
import javafx.util.StringConverter;
import javafx.util.converter.DoubleStringConverter;
import java.text.NumberFormat;
import java.text.ParsePosition;
public class NumericTextFieldFX extends Application {
    @Override
    public void start(Stage primaryStage) {
        TextField numericField = new TextField();
        // 创建一个 DoubleStringConverter
        DoubleStringConverter converter = new DoubleStringConverter();
        // 创建 TextFormatter
        // 过滤器会检查新的字符串是否可以转换为 Double
        TextFormatter<Double> formatter = new TextFormatter<>(converter,
                0.0, // 默认值
                c -> {
                    if (c.getControlNewText().isEmpty()) {
                        return null; // 允许清空
                    }
                    ParsePosition pos = new ParsePosition(0);
                    // 尝试解析
                    Object obj = NumberFormat.getInstance().parse(c.getControlNewText(), pos);
                    // 如果解析到了字符串的末尾，说明是合法的数字
                    if (obj == null || pos.getIndex() < c.getControlNewText().length()) {
                        return null; // 非法输入
                    }
                    return c; // 合法输入
                });
        numericField.setTextFormatter(formatter);
        VBox root = new VBox(10, numericField);
        root.setPadding(new javafx.geometry.Insets(15));
        primaryStage.setScene(new Scene(root, 300, 150));
        primaryStage.setTitle("JavaFX 数字文本框");
        primaryStage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

说明： JavaFX 的 TextFormatter 是一个非常强大的工具，它结合了数据转换和输入过滤，上面的例子允许输入整数和小数，如果你只想输入整数，可以改用 IntegerStringConverter 并相应地调整过滤器逻辑。

Web 开发 (HTML/JS)

如果你指的是网页中的输入框,那么应该在 HTML 和 JavaScript 中实现。

HTML: 使用 input 标签的 type 属性是最简单的方式。

<!-- 只能输入整数 -->
<input type="number" id="myNumberInput">
<!-- 或者使用 pattern 属性进行更严格的控制 -->
<input type="text" id="myPatternInput" pattern="[0-9]*">

JavaScript (增强验证和用户体验): 虽然 type="number" 在移动端会弹出数字键盘，但在桌面端仍可能输入非数字字符，通常会用 JS 来加强验证。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">Web 数字输入框</title>
</head>
<body>
    <h2>只能输入数字的文本框</h2>
    <input type="text" id="numericInput" placeholder="请输入数字">
    <script>
        const input = document.getElementById('numericInput');
        // 方法1：使用 input 事件
        input.addEventListener('input', function() {
            // 使用正则表达式替换所有非数字字符
            this.value = this.value.replace(/[^0-9]/g, '');
        });
        // 方法2：使用 keypress 事件 (更严格，但可能影响粘贴)
        /*
        input.addEventListener('keypress', function(e) {
            // 检查按下的键是否是数字 (0-9)
            if (!/[0-9]/.test(e.key) && 
                !['Backspace', 'Delete', 'ArrowLeft', 'ArrowRight', 'Tab'].includes(e.key)) {
                e.preventDefault(); // 阻止默认行为
            }
        });
        */
    </script>
</body>
</html>

总结与推荐

对于你的问题“文本框只能输入数字 java”，如果你指的是 Java Swing，DocumentFilter 是你应该学习和使用的最佳方案。