配置DocumentFilter限制jTextField仅输入数字后，字符串转整数解析出错

我来帮你梳理清楚问题所在，以及对应的解决办法：

核心问题分析 #

1. KeyTyped事件触发时机错误
   这个事件是在字符还没插入到文本框时触发的，你此时调用jTextField1.getText()拿到的是输入前的旧值，甚至可能是空字符串——这就是Integer.parseInt()直接报错的根本原因（空串无法解析为整数）。

2. 重复绑定过滤器与监听器
   每次用户输入字符，你都会重新给文本框的Document绑定一次DocumentFilter和DocumentListener，这会导致多个实例同时生效，逻辑混乱，甚至引发意想不到的异常。

3. 缺少空值与异常兜底
   即使有数字过滤器，文本框也可能处于空状态，直接调用Integer.parseInt()没有任何判断，必然抛出NumberFormatException。

正确的实现方式 #

我们需要把过滤器和监听器的绑定移到组件初始化阶段（只绑定一次），然后通过DocumentListener监听文本的真实变化，在文本更新完成后再进行值判断：

1. 初始化时绑定过滤器与监听器 #

public class YourFrame extends JFrame {
    public YourFrame() {
        initComponents();
        // 获取文本框的Document实例
        AbstractDocument doc = (AbstractDocument) jTextField1.getDocument();
        
        // 一次性绑定数字过滤器（只允许1位数字）
        doc.setDocumentFilter(new JTextFieldFilter(1, 1));
        // 绑定你的JButtonStateController监听器
        doc.addDocumentListener(new JButtonStateController(MultiPlayerGoButton, 0));
        
        // 添加监听文本变化的监听器，用于判断值是否为2
        doc.addDocumentListener(new DocumentListener() {
            @Override
            public void insertUpdate(DocumentEvent e) {
                checkInputValue();
            }

            @Override
            public void removeUpdate(DocumentEvent e) {
                checkInputValue();
            }

            @Override
            public void changedUpdate(DocumentEvent e) {
                checkInputValue();
            }
        });
    }

    // 专门处理文本框值判断的方法
    private void checkInputValue() {
        String inputText = jTextField1.getText().trim();
        
        // 先判断文本是否为空，避免解析异常
        if (inputText.isEmpty()) {
            // 空文本的处理逻辑，比如重置按钮状态等
            return;
        }
        
        try {
            int inputValue = Integer.parseInt(inputText);
            if (inputValue == 2) {
                // 这里写你要执行的业务逻辑
                System.out.println("输入值为2，执行对应操作");
            }
        } catch (NumberFormatException ex) {
            // 因为有数字过滤器，这里基本不会触发，但做兜底处理更稳妥
            ex.printStackTrace();
        }
    }

    // 原来的KeyTyped方法可以清空，不需要再做任何操作
    private void jTextField1KeyTyped(java.awt.event.KeyEvent evt) { 
        // 空实现即可，或者直接删除这个方法（如果是IDE自动生成的）
    }
}

2. 确保数字过滤器逻辑正确 #

为了避免过滤器失效，这里给你一个标准的数字长度限制过滤器实现参考：

class JTextFieldFilter extends DocumentFilter {
    private final int minLength;
    private final int maxLength;

    public JTextFieldFilter(int minLength, int maxLength) {
        this.minLength = minLength;
        this.maxLength = maxLength;
    }

    @Override
    public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException {
        // 只允许输入数字
        if (string.matches("\\d+")) {
            String newText = fb.getDocument().getText(0, fb.getDocument().getLength()) + string;
            // 限制长度不超过maxLength
            if (newText.length() <= maxLength) {
                super.insertString(fb, offset, string, attr);
            }
        }
    }

    @Override
    public void replace(FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException {
        if (text.matches("\\d+")) {
            String currentText = fb.getDocument().getText(0, fb.getDocument().getLength());
            String newText = currentText.substring(0, offset) + text + currentText.substring(offset + length);
            if (newText.length() <= maxLength) {
                super.replace(fb, offset, length, text, attrs);
            }
        }
    }
}

为什么这样修改能解决问题？ #

• 过滤器和监听器只绑定一次，避免了重复绑定导致的逻辑混乱；
• 通过DocumentListener监听文本的插入/删除/修改事件，确保我们拿到的是最新的、已经插入完成的文本值；
• 增加了空值判断和异常捕获，避免了解析时的崩溃问题。

内容的提问来源于stack exchange，提问作者Arihant Bedagkar