JTextField输入时限制字符且不显示多余字符，支持加载长数据编辑

核心思路是使用DocumentFilter替代KeyListener——它能在文本插入/替换前就进行长度校验和截断，从根源上避免多余字符先显示再被删除的问题，完美适配你的场景：

实现步骤 #

1. 自定义长度限制的DocumentFilter #

这个过滤器会拦截所有文本变更请求，提前计算长度并截断超出部分：

import javax.swing.text.AttributeSet;
import javax.swing.text.BadLocationException;
import javax.swing.text.DocumentFilter;

public class LengthLimitFilter extends DocumentFilter {
    private final int maxLength;

    public LengthLimitFilter(int maxLength) {
        this.maxLength = maxLength;
    }

    // 处理文本插入（比如直接输入、粘贴）
    @Override
    public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException {
        int currentLength = fb.getDocument().getLength();
        int available = maxLength - currentLength;
        if (available <= 0) {
            return; // 无剩余空间，直接拒绝插入
        }
        if (string.length() > available) {
            string = string.substring(0, available); // 截断多余字符
        }
        super.insertString(fb, offset, string, attr);
    }

    // 处理文本替换（比如选中后输入、粘贴覆盖）
    @Override
    public void replace(FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException {
        int currentLength = fb.getDocument().getLength();
        int available = maxLength - (currentLength - length);
        if (available <= 0) {
            return; // 无剩余空间，直接拒绝替换
        }
        if (text.length() > available) {
            text = text.substring(0, available); // 截断多余字符
        }
        super.replace(fb, offset, length, text, attrs);
    }
}

2. 给JTextField绑定过滤器 #

将自定义过滤器设置到文本框的Document上，同时处理数据库超长文本的加载：

import javax.swing.JTextField;
import javax.swing.text.PlainDocument;

// 示例代码
public class TextFieldSetup {
    public static void main(String[] args) {
        JTextField textField = new JTextField();
        int MAX_ALLOWED_LENGTH = 50; // 你的限定长度

        // 绑定过滤器
        PlainDocument doc = (PlainDocument) textField.getDocument();
        doc.setDocumentFilter(new LengthLimitFilter(MAX_ALLOWED_LENGTH));

        // 加载数据库超长文本：直接截断后显示，同时保留完整文本用于后续更新
        String dbLongText = "从数据库读取的超长原始文本内容...";
        textField.setText(dbLongText.length() > MAX_ALLOWED_LENGTH 
            ? dbLongText.substring(0, MAX_ALLOWED_LENGTH) 
            : dbLongText);
        // 把完整的数据库文本存到文本框的客户端属性，方便更新时使用
        textField.putClientProperty("fullDbContent", dbLongText);
    }
}

关键说明 #

• 完全避免多余字符闪现：所有文本变更都在进入Document前被处理，用户看不到任何超出长度的字符。
• 适配数据库加载场景：加载时直接截断显示，同时通过putClientProperty保留完整原始文本，后续更新数据库时可以根据需求选择使用编辑后的截断文本，或者将编辑内容替换到原始超长文本中再提交。

内容的提问来源于stack exchange，提问作者Dinuka Kasun Medis