本文介绍如何使用 Java Swing 的 JFormattedTextField 与自定义 AbstractFormatterFactory，实现信用卡号输入框的“编辑态显示完整号码、非编辑态仅显示后四位（如 XXXXXXXXXXXX1456）”这一典型安全交互需求。
本文介绍如何使用 java swing 的 `jformattedtextfield` 与自定义 `abstractformatterfactory`，实现信用卡号输入框的“编辑态显示完整号码、非编辑态仅显示后四位（如 xxxxxxxxxxxx1456）”这一典型安全交互需求。
在开发金融类或支付相关桌面应用（如课程要求的超市收银系统）时，出于用户隐私与界面友好性考虑，常需对敏感字段（如信用卡号）进行差异化显示：用户正在输入时应看到完整数字以便核对；而当焦点离开该字段后，则自动遮蔽前12位，仅保留末4位可见（例如 4532019876541456 → XXXXXXXXXXXX1456）。Java Swing 原生不提供此类行为，但可通过 JFormattedTextField 的 Formatter 机制优雅实现。
核心思路是利用 JFormattedTextField 的双态格式化能力——它支持为「编辑态」（hasFocus == true）和「显示态」（hasFocus == false）分别指定不同的 AbstractFormatter。我们据此设计三部分逻辑：
- CreditCardFormatterFactory：继承 AbstractFormatterFactory，重写 getFormatter() 方法，根据组件焦点状态动态返回对应 formatter；
- CreditCardEditFormatter：编辑态 formatter，不做遮蔽，原样显示用户输入（便于实时校验与修改）；
- CreditCardDisplayFormatter：显示态 formatter，在 valueToString() 中执行脱敏逻辑：若字符串长度 ≥ 16，截取后4位并前置12个 'X'；若不足12位（如测试输入过短），则全部替换为 'X'，确保视觉一致性。
以下是精简可运行的完整示例（已移除冗余日志，增强健壮性）：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
import javax.swing.*;
import javax.swing.text.MaskFormatter;
import java.awt.*;
import java.text.ParseException;
public class CreditCardFieldDemo {
public static void main(String[] args) {
SwingUtilities.invokeLater(() -> {
JFrame frame = new JFrame("信用卡号输入框示例");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setLayout(new BorderLayout());
// 标签 + 格式化文本框
JPanel panel = new JPanel(new FlowLayout());
panel.add(new JLabel("卡号："));
JFormattedTextField cardField = new JFormattedTextField(
new CreditCardFormatterFactory());
cardField.setColumns(18);
panel.add(cardField);
// 提交按钮（仅作演示，实际可获取 getText() 获取完整值）
JButton submitBtn = new JButton("提交");
submitBtn.addActionListener(e ->
JOptionPane.showMessageDialog(frame,
"当前完整卡号：" + cardField.getValue())
);
panel.add(submitBtn);
frame.add(panel, BorderLayout.CENTER);
frame.pack();
frame.setLocationRelativeTo(null);
frame.setVisible(true);
});
}
}
class CreditCardFormatterFactory extends JFormattedTextField.AbstractFormatterFactory {
private final JFormattedTextField.AbstractFormatter editFormatter = new CreditCardEditFormatter();
private final JFormattedTextField.AbstractFormatter displayFormatter = new CreditCardDisplayFormatter();
@Override
public JFormattedTextField.AbstractFormatter getFormatter(JFormattedTextField ftf) {
return ftf.hasFocus() ? editFormatter : displayFormatter;
}
}
class CreditCardEditFormatter extends JFormattedTextField.AbstractFormatter {
@Override
public Object stringToValue(String text) throws ParseException {
return text == null ? "" : text.replaceAll("\D", ""); // 清除非数字字符（可选增强）
}
@Override
public String valueToString(Object value) throws ParseException {
return value == null ? "" : value.toString();
}
}
class CreditCardDisplayFormatter extends JFormattedTextField.AbstractFormatter {
@Override
public Object stringToValue(String text) throws ParseException {
return text;
}
@Override
public String valueToString(Object value) throws ParseException {
if (value == null) return "";
String raw = value.toString().replaceAll("\D", ""); // 统一处理：只保留数字
int len = raw.length();
if (len == 0) return "";
if (len <= 4) return raw; // 全部显示（极短输入）
// 遮蔽前 n-4 位，保留后4位
return "X".repeat(Math.max(0, len - 4)) + raw.substring(len - 4);
}
}✅ 关键注意事项：
立即学习“Java免费学习笔记（深入）”；
- JFormattedTextField.getValue() 始终返回原始未脱敏的字符串（即用户真实输入），脱敏仅作用于显示层，不影响业务逻辑取值；
- 示例中 CreditCardEditFormatter.stringToValue() 添加了 replaceAll("\D", "")，可自动过滤空格、短横线等非数字字符，提升用户体验（如支持 4532-0198-7654-1456 输入）；
- 若需进一步校验卡号有效性（Luhn算法），应在 stringToValue() 或提交时统一处理，切勿在 valueToString() 中修改原始值；
- 此方案完全兼容标准 Swing 事件模型（如 DocumentListener、ActionListener），无需额外适配。
通过上述设计，你不仅满足了课程作业中“仅显示后四位”的硬性要求，更构建了一个可复用、易扩展的敏感字段显示组件——未来如需支持身份证、手机号等类似脱敏场景，只需调整 CreditCardDisplayFormatter.valueToString() 的规则即可。
