讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在用户编辑前为 JFormattedTextField 设置非法字符串值

夏宇吖_1963

夏宇吖_1963

发布时间:2026-01-14 09:59:11

|

652人浏览过

|

来源于php中文网

原创

如何在用户编辑前为 JFormattedTextField 设置非法字符串值

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),避免线程安全问题。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2991

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

554

2025.10.31

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

522

2026.02.12

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6439

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1678

2024.03.01

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1749

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1211

2024.06.27

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

20

2026.10.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn