1. 为什么 Swing 表单里总缺一个顺手的日期选择控件做 Java 桌面端表单的人大概都遇到过这个尴尬JTextField 让用户手敲日期格式五花八门2024-1-1、2024/01/01、2024年1月1日 全都能输进来后端解析时直接抛 ParseException换成 JLabel 展示日期又只能看不能改想调整还得再挂个按钮弹对话框。Swing 自带 JSpinner 配 SpinnerDateModel 勉强能用但那个上下箭头的小交互用户点起来是真的别扭而且没法做「点击输入框直接弹日历」这种符合直觉的操作。这篇要解决的就是这件事给 JLabel 和 JTextField 都挂上同一个日期选择控件点一下弹出月历面板选完自动回填格式统一走 SimpleDateFormat 校验。核心思路是把日历面板做成一个可复用的 DateChooser 类内部用 Popup 承载月历通过 register 方法把任意 JComponent 注册进去再根据组件类型决定回填方式——JTextField 走 setTextJLabel 也走 setText逻辑几乎一致。适合谁看正在维护老 Swing 项目、需要快速给现有表单加日期能力的开发者或者刚接触 Swing 事件模型想通过一个完整案例理解 MouseListener、Popup、Calendar 配合方式的人。下面给出的代码可以直接复制进项目跑起来我会把控件封装、监听绑定、JFrame 验证步骤拆开讲最后附上几个我实际踩过的坑。2. 前置准备TaoToken 接入与开发环境确认在动手写控件之前先把两件事理清楚一是 JDK 环境二是如果你打算在调试过程中用大模型辅助排查 Swing 事件问题可以顺手把 TaoToken 的 API 接进来。Swing 本身不需要任何外部依赖JDK 8 以上就能跑但事件调试时经常需要反复问「为什么 Popup 不消失」「为什么 focusLost 触发顺序不对」这时候有个稳定的模型对话入口会省不少时间。TaoToken 的接入方式很简单官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。如果你只是想在写代码时随时问几句用模型对话就行如果是长期做 Swing 重构、需要模型帮你批量分析事件监听链路可以看 Coding Plan。API Key 在控制台的 api-keys 页面生成文档在 doc 页面。环境确认清单项目要求说明JDK8 及以上Swing 在 JDK 8 稳定JDK 17 也能跑IDEIDEA / Eclipse 均可需要能直接运行 main 方法编码UTF-8源码里有中文避免乱码依赖无纯 JDK不需要 Maven 坐标有一点要提醒Swing 的所有 UI 操作必须在事件分发线程EDT里执行后面 main 方法里我会用 SwingUtilities.invokeLater 包一层这是很多新手直接 new JFrame 后遇到「界面偶尔卡死」的根因。如果你在调试时把异常堆栈贴给模型分析记得把完整 stack trace 带上只说「报错了」模型也猜不准。3. 可复制配置DateChooser 控件封装与监听绑定这一节是全文的核心我把 DateChooser 拆成几个关键部分讲面板结构、Popup 弹出逻辑、register 注册方法、以及 JTextField 和 JLabel 的回填分支。代码可以直接建一个 com.monitor.date 包放进去。先看类的基本结构和单例工厂方法。DateChooser 继承 JPanel内部持有 Calendar select 记录当前选中日期SimpleDateFormat sdf 控制格式Popup pop 承载弹出的月历。工厂方法提供四种重载最常用的是 getInstance(String format)package com.monitor.date; import javax.swing.*; import javax.swing.event.AncestorEvent; import javax.swing.event.AncestorListener; import java.awt.*; import java.awt.event.*; import java.text.SimpleDateFormat; import java.util.Calendar; import java.util.Date; public class DateChooser extends JPanel { private static final long serialVersionUID 4529266044762990227L; private Date initDate; private Calendar now Calendar.getInstance(); private Calendar select; private JPanel monthPanel; private SimpleDateFormat sdf; private boolean isShow false; private Popup pop; private JComponent showDate; public static DateChooser getInstance() { return new DateChooser(); } public static DateChooser getInstance(String format) { return new DateChooser(format); } public static DateChooser getInstance(Date date, String format) { return new DateChooser(date, format); } private DateChooser() { this(new Date()); } private DateChooser(String format) { this(new Date(), format); } private DateChooser(Date date, String format) { initDate date; sdf new SimpleDateFormat(format); select Calendar.getInstance(); select.setTime(initDate); initPanel(); } }initPanel 负责搭建月历面板用 BorderLayout 分成上中下三块顶部是年月切换栏中间是星期标题加日期网格底部是「今天」快捷入口。这里有个细节addAncestorListener 监听 ancestorMoved只要祖先组件移动就立刻隐藏 Popup否则窗口拖动时日历会飘在错误位置private void initPanel() { monthPanel new JPanel(new BorderLayout()); monthPanel.setBorder(BorderFactory.createLineBorder(Color.BLUE)); JPanel up new JPanel(new BorderLayout()); up.add(new JP1(), BorderLayout.NORTH); up.add(new JP2(), BorderLayout.CENTER); monthPanel.add(new JP3(), BorderLayout.CENTER); monthPanel.add(up, BorderLayout.NORTH); monthPanel.add(new JP4(), BorderLayout.SOUTH); this.addAncestorListener(new AncestorListener() { public void ancestorAdded(AncestorEvent event) {} public void ancestorRemoved(AncestorEvent event) {} public void ancestorMoved(AncestorEvent event) { hidePanel(); } }); }register 方法是整个控件的入口它接收一个 JComponent给它挂上鼠标监听和焦点监听。鼠标进入变手型、按下切换 Popup 显示隐藏、焦点丢失自动收起。注意这里对 JTextField 和 JLabel 是一视同仁的因为两者都继承自 JComponentpublic void register(final JComponent showDate) { this.showDate showDate; showDate.setRequestFocusEnabled(true); showDate.addMouseListener(new MouseAdapter() { public void mousePressed(MouseEvent me) { showDate.requestFocusInWindow(); } }); this.setBackground(Color.WHITE); this.add(showDate, BorderLayout.CENTER); this.setPreferredSize(new Dimension(90, 25)); this.setBorder(BorderFactory.createLineBorder(Color.GRAY)); showDate.addMouseListener(new MouseAdapter() { public void mouseEntered(MouseEvent me) { if (showDate.isEnabled()) { showDate.setCursor(new Cursor(Cursor.HAND_CURSOR)); showDate.setForeground(Color.RED); } } public void mouseExited(MouseEvent me) { if (showDate.isEnabled()) { showDate.setCursor(new Cursor(Cursor.DEFAULT_CURSOR)); showDate.setForeground(Color.BLACK); } } public void mousePressed(MouseEvent me) { if (showDate.isEnabled()) { showDate.setForeground(Color.CYAN); if (isShow) { hidePanel(); } else { showPanel(showDate); } } } public void mouseReleased(MouseEvent me) { if (showDate.isEnabled()) { showDate.setForeground(Color.BLACK); } } }); showDate.addFocusListener(new FocusListener() { public void focusLost(FocusEvent e) { hidePanel(); } public void focusGained(FocusEvent e) {} }); }回填逻辑在 commit 方法里这是 JTextField 和 JLabel 唯一分叉的地方。判断组件类型后分别强转调用 setText格式统一用 sdf.format(select.getTime())这样无论用户怎么点回填的字符串格式都是构造时指定的private void commit() { if (showDate instanceof JTextField) { ((JTextField) showDate).setText(sdf.format(select.getTime())); } else if (showDate instanceof JLabel) { ((JLabel) showDate).setText(sdf.format(select.getTime())); } hidePanel(); }showPanel 负责计算弹出位置用 SwingUtilities.convertPointToScreen 把组件坐标转成屏幕坐标再根据屏幕宽高做边界修正防止日历弹到屏幕外。这段逻辑在 excerpt 里已经比较完整我补充一点y 坐标判断里如果下方空间不足就往上弹这个 188 是月历面板的大致高度你可以根据实际面板尺寸调整。4. 验证请求在 JFrame 中运行并观察回填结果控件写完后用一个最小 JFrame 验证。main 方法里创建两个 DateChooser 实例分别注册 JTextField 和 JLabel放进窗口的 NORTH 和 SOUTH 位置public static void main(String[] args) { SwingUtilities.invokeLater(() - { DateChooser dateChooser1 DateChooser.getInstance(yyyy-MM-dd); DateChooser dateChooser2 DateChooser.getInstance(yyyy-MM-dd); JTextField showDate1 new JTextField(单击选择日期); JLabel showDate2 new JLabel(单击选择日期); dateChooser1.register(showDate1); dateChooser2.register(showDate2); JFrame jf new JFrame(测试日期选择器); jf.setLayout(new BorderLayout()); jf.add(showDate1, BorderLayout.NORTH); jf.add(showDate2, BorderLayout.SOUTH); jf.pack(); jf.setLocationRelativeTo(null); jf.setVisible(true); jf.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); }); }运行后你应该看到窗口顶部是一个带边框的输入框显示「单击选择日期」鼠标移上去变手型、文字变红点击后下方弹出蓝色边框的月历面板顶部显示「2024年X月」左右各有年月切换箭头中间是 6 行 7 列的日期网格当前日期有红框选中日期有蓝色高亮点击某个日期后输入框文字变成 yyyy-MM-dd 格式并自动收起面板。底部 JLabel 的行为完全一致点一下同样弹日历、选完回填。验证时重点观察三个点一是点击输入框时 Popup 是否出现在组件正下方如果出现在屏幕左上角说明 convertPointToScreen 的调用有问题二是切换月份时日期网格是否正确刷新跨年切换12月到1月要特别看一下三是点击「今天」快捷入口日期是否立刻回填并收起面板。如果你在调试过程中遇到事件不触发、Popup 不消失这类问题可以把完整的监听器代码和现象描述贴到模型对话里让它帮你逐行分析事件传播顺序。对于需要长期维护 Swing 项目的团队Coding Plan 能提供更连续的上下文避免每次都要重新描述项目结构。5. 本篇常见错排查401、Popup 不消失与日期错位实际跑这段代码时我遇到过几个典型问题列出来对照排查。第一个是 Popup 弹出后点击其他组件不消失。原因通常是 focusLost 没有触发因为 JLabel 默认不可聚焦。解决办法是在 register 里对 JLabel 显式设置 setFocusable(true)或者改用 AncestorListener 的 ancestorMoved 兜底。如果你发现点击窗口空白处日历还挂着先检查 showDate 是否真的获得了焦点。第二个是日期回填后格式不对比如显示成「2024年1月1日」而不是「2024-01-01」。这是 SimpleDateFormat 构造时传的 format 字符串和预期不一致检查 getInstance 调用处传的参数。注意 sdf 是实例变量getStrDate(String format) 方法会重新赋值 sdf如果同一个 DateChooser 实例被多个组件共用格式会互相覆盖建议一个组件一个实例。第三个是跨月切换时日期网格错位。JP3 的 updateDate 里用 Calendar.DAY_OF_WEEK 计算起始偏移如果 select 的 DAY_OF_MONTH 没有先 set 到 1偏移量会算错。代码里已经做了 select.set(Calendar.DAY_OF_MONTH, 1)但如果你自己改过这段逻辑要确保这个重置在计算 index 之前。第四个是拖动窗口时日历面板留在原地。这是 ancestorMoved 没生效检查 addAncestorListener 是否加在了 monthPanel 而不是 this 上。另外 Popup 是重量级组件某些平台下拖动窗口时不会自动跟随ancestorMoved 里调 hidePanel 是最稳妥的做法。如果你在接入 TaoToken 调试时遇到 401先确认 API Key 是否在 api-keys 页面正确生成、请求头是否带了 Authorization。接入文档在 doc 页面有完整的请求示例对照检查 Base URL 是否写成了 https://taotoken.net/api 而不是带路径的地址。6. 把日期选择能力接进现有表单的下一步控件跑通后接入现有表单其实就三步把 DateChooser 类复制进项目在表单初始化处对每个日期字段调 register然后根据字段类型决定用 JTextField 还是 JLabel。如果表单里日期字段很多可以写个工具方法批量注册避免重复代码。有个实用技巧如果某个日期字段需要限制可选范围比如只能选今天之后的日期可以在 MyLabel 的 setSelected 里加判断超出范围的日期直接 return 不更新 select。这样用户点了也不会回填比事后校验体验好。另外SimpleDateFormat 不是线程安全的虽然 Swing 的事件都在 EDT 里串行执行但如果你在后台线程里调 getStrDate记得每次 new 一个 SimpleDateFormat 或者用 ThreadLocal 包一层。这个坑我在一个批量导出报表的功能里踩过表现是偶尔日期格式化出错排查了半天才发现是共享了 sdf 实例。最后如果你打算把这个控件用到生产项目里建议把月历面板的配色、字体抽成配置项不同项目的 UI 规范不一样硬编码颜色后期改起来很烦。我现在的做法是构造时传一个 StyleConfig 对象默认值走内置样式需要定制时覆盖对应字段就行。