
jformattedtextfield 默认要求 setvalue() 传入与格式器匹配的合法对象(如 number),若需预设非法字符串(如提示文本),应改用 settext(),并配合 setallowsinvalid(true) 和 setcommitsonvalidedit(false) 等设置确保显示与行为符合预期。
JFormattedTextField 的设计初衷是严格校验输入值类型:其 setValue(Object) 方法会尝试将传入对象通过关联的 Formatter(如 NumberFormatter)进行格式化或解析;若对象类型不兼容(例如向 NumberFormatter 传入 String),便会抛出 IllegalArgumentException(如 "Cannot format given Object as a Number")。因此,直接调用 ftf.setValue("I want this...") 必然失败。
正确做法是使用 setText(String) —— 它绕过格式器校验,直接设置显示文本,适用于占位符、初始提示或非法默认值。但仅此还不够,还需合理配置格式器行为:
- ✅ nfter.setAllowsInvalid(true):允许文本框显示非法内容(否则非法字符串会被自动清空或替换为 null);
- ✅ nfter.setCommitsOnValidEdit(false):避免在初始化时因非法文本触发 commit 导致值被重置为 null;
- ⚠️ 避免 setCommitsOnValidEdit(true)(答案中建议有误):该设置会使文本框在每次合法编辑后立即提交值,但初始非法文本无法触发 commit,反而可能导致 getValue() 返回 null,且与“预设非法值”的目标冲突。
以下是修正后的完整示例代码:
import javax.swing.*;
import javax.swing.text.NumberFormatter;
import java.text.NumberFormat;
import java.awt.*;
public class MyGUI {
private JFrame f;
private JPanel p;
private JFormattedTextField ftf;
private NumberFormat nf;
private NumberFormatter nfter;
public MyGUI() {
f = new JFrame("My Window");
f.setSize(960, 450);
f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
f.setLocationRelativeTo(null);
p = new JPanel();
p.setLayout(new FlowLayout());
f.add(p);
nf = NumberFormat.getInstance();
nfter = new NumberFormatter(nf);
nfter.setAllowsInvalid(true); // 关键:允许显示非法字符串
nfter.setCommitsOnValidEdit(false); // 关键:避免非法初始值被清空
ftf = new JFormattedTextField(nfter);
// ✅ 使用 setText 设置非法初始文本
ftf.setText("I want this as my ftf's value before it gets changed");
p.add(ftf);
f.setVisible(true); // 建议放在最后,确保组件已添加完毕
}
public static void main(String[] args) {
SwingUtilities.invokeLater(MyGUI::new);
}
}注意事项总结:
- setText() 是设置非法初始值的唯一可靠方式;setValue() 仅适用于合法数据类型(如 setValue(123))。
- setAllowsInvalid(true) 必须启用,否则非法文本会被格式器自动过滤。
- setCommitsOnValidEdit(false) 更安全:它让 getValue() 在非法状态下返回 null(可主动判断),而非意外触发无效 commit。
- 若后续需获取用户输入的有效数值,请在焦点离开或回车事件中调用 ftf.getCommitValue() 或检查 ftf.getValue() 是否为 Number 实例。
- 所有 Swing 组件操作应在 Event Dispatch Thread 中执行(如 SwingUtilities.invokeLater),避免线程安全问题。









