Java Swing 实现可交互图形日历

结果与目标

最终实现的应用程序主界面将包含以下部分：

• 顶部控制面板：显示北京时间，并提供“年份”、“月份”、“日期”三个联动的下拉列表框（JComboBox）以及查询按钮。
• 日历网格：采用 GridLayout(7, 7) 布局展示一周七天及当月所有日期。空白位置由空按钮填充，选中日期会显示为带有 “#” 前缀的文本（例如 "#15"）。

图片：Java GUI 日历主界面示例

准备条件

开发环境需支持 Java SE，重点依赖 java.awt 和 javax.swing 包下的类，以及用于时间处理的 java.util.Calendar。

真实操作顺序

第1步：定义界面容器与静态组件

目的：初始化窗口框架（JFrame）、内容面板（Container）及主要布局面板。

动作：

1. 创建 JFrame 实例并设置为不可变大小（setResizable(false)）。
2. 设置主布局为 BorderLayout，中间区域（CENTER）预留为空板 p_mid，用于后续渲染日历网格。
3. 实例化三个下拉框：box1（年份）、box2（月份）、box3（日期），分别用于存储用户选择的年、月、日字符串。

第2步：构建头部时间与联动控件区

目的：在 NORTH 区域添加日期展示和筛选控件，并注册监听器。

动作：

• 显示时间：使用 SimpleDateFormat("YYYY-MM-dd") 格式化当前系统时间为字符串，写入标签。
• 初始化选项：手动向 box1 添加固定年份（如 2016-2019），向 box2 添加 "--月份--" 占位符，向 box3 添加 "--日期--" 占位符。
• 绑定逻辑：
  • 给 box1 绑定 ActionListener：当年份改变时，触发月份下拉框的重建逻辑。
  • 给 box2 绑定 ActionListener：根据选中月份的天数规则（31/30/28或29），调用 combox() 方法重置 box3 的内容模型。

第3步：实现下拉框的动态数据更新

目的：解决日历月份切换时，日期下拉框数据不刷新的问题。

原理：JComboBox 推荐使用 DefaultComboBoxModel 来管理数据源，修改模型比直接移除添加子项更稳定。

// 根据月份设置对应的天数范围
if(month.equals("2")) { 
    // 闰年判断逻辑简化演示
    int days = (isLeapYear(year) ? 29 : 28);
    setupDayBox(days);
} else {
    int days = (month.matches("[4,6,9]|11") ? 30 : 31);
    setupDayBox(days);
}

private void setupDayBox(int maxDays) {
    String[] days = new String[maxDays + 1];
    days[0] = "--日期--";
    for(int i=1; i<=maxDays; i++) days[i] = String.valueOf(i);
    box3.setModel(new DefaultComboBoxModel(days));
}

第4步：核心日历网格渲染算法

目的：根据选定的年月，计算该月的第一天是星期几，并正确排列日期数字。

入口：点击“查询”按钮或初始化界面时。

参数：

• year, month, day：用户选定的目标时间。

步骤：

1. 清空旧网格：调用 p_mid.removeAll() 和 con.remove(p_mid) 清除上一轮生成的日期组件。
2. 获取偏移量：使用 Calendar 对象：
   - 设置日期为当月 1 号。
   - 获取 DAY_OF_WEEK（范围为 1-Sun 到 7-Sat）。为了对齐周日开始的表格习惯，通常做减一处理：若结果为 0（即原为7/Sat），则设为 7；若为其他值，保持原状（此处代码逻辑假设周一开始或做了特定转换，需注意不同平台对 DAY_OF_WEEK 的首日定义差异）。
3. 生成方块：由于日历网格通常按 7x6（42格）绘制以确保视觉稳定：
   - 从第 1 格遍历到第 42 格。
   - 如果当前索引 i 在有效日期范围内（Week <= i < Week + MaxDays），生成一个 JButton。
   - 若当前日期等于用户选中的日期，按钮文本设为 "#" + 日期；否则设为纯日期数字。
4. 刷新视图：将填充好的 p_mid 重新添加到容器中，并强制调用 validate() 触发重绘。

完成判断

运行程序后，界面正常加载显示当年日历。更改年份或月份时，下方的日期下拉框应同步更新可用天数。点击确认后，中间的日历网格应以所选日期为中心（或对应位置出现带 # 标记的按钮）重新渲染，且无闪烁或错位。

原文有依据的排错

在开发此类 Java Swing 图形界面时，常遇到以下两个典型问题：

1. JComboBox 数据更新失效：
   早期尝试直接在循环中添加或删除 addItem，导致内存溢出或状态混乱。查阅源码后发现必须维护一个 ComboBoxModel。通过将新计算的字符串数组封装进 DefaultComboBoxModel 并赋值给 setModel，可以安全地替换所有选项。

box.setModel(new DefaultComboBoxModel<String>(newStrArray));

2. UI 动态刷新卡顿或缺失：
   在移除旧组件并添加新组件后，有时发现面板并未立即更新，需要最小化再恢复窗口才能看到变化。这是因为 Swing 的布局管理器缓存了布局信息。解决方法是在添加完所有子组件后，显式调用父容器（ContentPane）的 validate() 方法，它会强制重新计算布局并重绘组件。

con.validate();

简要总结

本示例展示了如何使用标准的 Java AWT/Swing 库构建基于时间的可视化工具。其关键在于理解 Calendar 类的日期属性提取以及 DefaultComboBoxModel 在动态 UI 元素中的应用。通过分离数据逻辑（计算日期）与表现逻辑（绘制按钮），可以有效实现各类复杂的交互式日历功能。

以上就是 Java 实现图形化界面日历的详细内容，更多关于 Java Swing 图形界面编程的资料请关注本站其它相关文章！