Java万年历记事本课设：Swing实现日期算法与本地存储

简介这份JAVA万年历源码面向Java初学者与课程设计实践者以Swing构建图形界面将万年历显示与记事本功能合为一体帮助读者在完整可运行的项目中理解日期时间处理、界面布局与事件驱动编程。源码围绕Calendar与java.time的日期操作展开涵盖闰年判断、月份起始天与当月天数计算、月份下拉切换、日记的写入读取与删除确认以及ActionListener、MouseListener等事件响应机制并涉及文件读写与异常处理适合作为课程设计参考或Swing入门练手素材。资源包共1个文件为doc格式的课程设计报告约317KB内含总体设计、类与方法说明、运行效果描述及完整源代码便于对照理解程序结构与实现思路。目前已有185人学习可帮助读者快速把握项目组织方式与功能拆解逻辑。1. 从一份单文件课设说起万年历记事本要解决的真实需求课程设计最怕的不是功能多而是功能散。很多同学一上来就想做“大而全”的桌面应用结果两周下来界面没搭完日期逻辑还错着。这份 JAVA万年历源码 走的是另一条路一个calendar类、一个JFrame、左右分栏左边万年历、右边记事本把“看日期”和“记事情”这两件最日常的事绑在一起。它面向的是软件技术专业课程设计场景目标很明确——用 Swing 把日期计算、事件分发、文件读写串成一条能跑通的链路而不是堆砌框架。对正在找 Java 课设参考、想交一份结构完整方案的人来说这套源码的价值不在代码量而在于它把“日期算法 界面布局 本地存储”三件事压进了一个可讲清楚的最小闭环里。2. 总体设计左右分栏与单类职责的取舍2.1 为什么把日历和记事本放进同一个类这份源码只有一个calendar类继承JFrame同时实现ActionListener和MouseListener。从工程角度看单类承担了界面构建、事件响应、日期计算、文件读写四类职责耦合度偏高但从课设交付角度看它降低了编译和运行门槛——一个.java文件就能跑不需要额外配置包结构。我一般会跟做课设的同学说先保证能跑通、能讲清再谈拆分。这个项目的取舍逻辑是“可演示优先”所有面板、按钮、标签都作为成员变量持有事件回调里直接访问省去了大量传参。界面骨架用JSplitPane做水平分割右侧是记事本区RightPane左侧是日历区LeftPane。左侧再分三层LeftNorth放年份输入框、月份下拉框和查询按钮LeftCenter用GridLayout(7,7)铺 7 个星期标题加 42 个日期格子LeftPane底部放“回到今天”按钮。右侧用BorderLayout北边是当前选中日期的标题标签中间是带滚动条的JTextArea南边是保存和删除按钮。这种布局的好处是职责边界在视觉上很清楚答辩时指着界面就能讲模块划分。2.2 核心成员变量与状态管理源码里的成员变量大致分四组日期状态year、month、day、yearafterquery、monthafterquery、计算中间量startday、priormonth、prioryear、界面组件各类JPanel、JLabel、JButton、JTextField[]、JComboBox、以及标志位ischange、ischange_priornext。日期格子用JTextField[42]而不是JLabel是为了统一设置背景色和字体同时保留鼠标监听能力。42 个格子对应 6 行 × 7 列足够覆盖任意月份的最大排布。private JTextField ShowDays[] new JTextField[42]; private JComboBox MonthCombobox; private JTextArea CenterText; private String week[] {SUN,MON,TUE,WED,THU,FRI,SAT};这段声明里有两个设计点值得说。第一ShowDays固定 42 个避免了按月动态增删组件带来的重绘问题第二星期标题用字符串数组而不是枚举是为了直接塞进JLabel的setText减少类型转换。参数上week数组顺序决定了日历列的顺序如果要做周一开头的日历改这个数组和GetStartDay的偏移量即可不需要动布局代码。2.3 日期计算链路的三个方法万年历的核心不是界面是“某年某月第一天是星期几”。源码用IsLeapYear、GetTotalNumOfDays、GetStartDay三个方法串起这条链路。IsLeapYear按“能被 400 整除或能被 4 整除但不能被 100 整除”判断GetTotalNumOfDays从基准年累加到目标年再累加目标月之前的月份天数GetStartDay把总天数对 7 取模得到起始星期。这里源码用了一个startday0001 -32768的偏移量属于历史遗留写法实际含义是把基准点对齐到某个已知星期。public boolean IsLeapYear(int year) { return (year % 400 0) || (year % 4 0 year % 100 ! 0); } public int GetNumOfDaysInMonth(int year, int month) { if (month 1 || month 3 || month 5 || month 7 || month 8 || month 10 || month 12) return 31; if (month 4 || month 6 || month 9 || month 11) return 30; if (month 2) return IsLeapYear(year) ? 29 : 28; return 0; }GetNumOfDaysInMonth用了一串if而不是数组查表可读性一般但胜在直白答辩时不容易被问住。真正需要注意的是GetTotalNumOfDays的循环起点源码从-32767开始累加这个范围对课设演示够用但如果要做公元前的日期或者极端年份循环次数会很大。通常的做法是改用java.time.LocalDate的lengthOfMonth()和getDayOfWeek()一行就能替代整条链路但那就偏离了“手写日期算法”的课设初衷。我的建议是课设阶段保留手写逻辑讲清楚原理如果后续要扩展成正式工具再替换成java.time。3. 模块实现日历渲染、记事本存储与事件分发3.1 月份切换与 42 格渲染逻辑日历渲染的入口是PrintMonth(year, month, day)它先算出startday和当月天数dayinmonth再调用PrintMonthBody填充格子。填充规则是从startday开始依次写入 1 到dayinmonthstartday之前的格子清空startday dayinmonth之后的格子也清空。当前选中日期day用绿色、加粗、大字号高亮其余日期用白色小字背景统一深灰。public void PrintMonthBody(int startday, int dayinmonth, int day) { for (int i startday, n 1; i startday dayinmonth; i) { ShowDays[i].setText( n); ShowDays[i].setHorizontalAlignment(0); if (n day) { ShowDays[i].setForeground(Color.green); ShowDays[i].setFont(new Font(TimesRoman, Font.BOLD, 20)); } else { ShowDays[i].setFont(new Font(TimesRoman, Font.BOLD, 12)); ShowDays[i].setForeground(Color.white); } ShowDays[i].setBackground(Color.DARK_GRAY); n; } for (int i 0; i startday; i) { ShowDays[i].setText(); ShowDays[i].setBackground(Color.DARK_GRAY); } for (int i startday dayinmonth; i 42; i) { ShowDays[i].setText(); ShowDays[i].setBackground(Color.DARK_GRAY); } }这段代码有两个容易翻车的细节。第一setHorizontalAlignment(0)里的 0 对应SwingConstants.CENTER直接写数字虽然能跑但可读性差建议改成常量。第二清空格子时只清setText和背景色没有重置字体和前景色如果之前某个格子被高亮过复用时可能残留绿色字体。稳妥的做法是在清空循环里一并setForeground(Color.white)和setFont复位。月份切换通过MonthCombobox的ActionListener触发取getSelectedIndex() 1作为月份再调用PrintMonth重绘。年份查询则读YearText的文本Integer.parseInt后更新year同样重绘。3.2 记事本的文件命名与读写策略记事本的存储设计很朴素在程序运行目录下建一个Diary文件夹每个日期对应一个.txt文件文件名由key决定。key的拼接方式是year _ SwitchMonth _ day其中SwitchMonth是英文月份缩写。这个设计的好处是文件名自带日期语义用户直接去文件夹里也能看懂坏处是依赖英文缩写如果SwitchMonth方法里某个case写错源码里 10 月写成了Qct文件名就会跟着错。public void WriteRecord() { String content CenterText.getText(); try { File diaryDir new File(Diary); if (!diaryDir.exists()) diaryDir.mkdir(); File myfile new File(Diary/ key .txt); FileWriter record new FileWriter(myfile); record.write(content); record.close(); JOptionPane.showMessageDialog(this, Save success!); } catch (IOException ex) { JOptionPane.showMessageDialog(this, Save failed: ex.getMessage()); } }写文件用FileWriter直接覆盖读文件用FileReader逐字符拼接。这里有个课设里高频出现的坑ReadRecord里先new FileReader(myfile)再判断myfile.exists()如果文件不存在构造FileReader时就会抛FileNotFoundException后面的exists判断根本走不到。正确的顺序是先exists再构造流。另外删除文件源码用了Runtime.exec(cmd /c del ...)这在跨平台场景下直接失效而且路径里有空格就会断。更稳的写法是myfile.delete()一行搞定还不用处理IOException。3.3 事件监听的分发与鼠标选中日期整个类实现了ActionListener和MouseListener所有按钮通过addActionListener(this)注册日期格子通过addMouseListener(this)注册。actionPerformed里根据getActionCommand()或事件源区分动作Save、Delete、Query、prior、next、ToToday。鼠标事件里真正有用的是mouseClicked它从被点击的JTextField里取文本作为day更新右侧标题标签和key然后调用ReadRecord尝试加载当天日记。public void mouseClicked(MouseEvent e) { JTextField cell (JTextField) e.getSource(); String text cell.getText(); if (text null || text.isEmpty()) return; day Integer.parseInt(text); key year _ SwitchMonth _ day; NorthMonthDayYear.setText( year , SwitchMonth , day ); ReadRecord(); }这段逻辑的关键在于key的重算时机必须在读取日记之前更新否则读到的还是上一天的记录。另一个细节是空格子直接return避免parseInt抛NumberFormatException。事件分发用getActionCommand而不是e.getSource() button好处是同一个监听器可以处理多个按钮坏处是命令字符串写错时编译期发现不了只能运行时排查。我一般会在注册时统一用常量定义命令名减少拼写错误。4. 避坑与排查课设里最容易翻车的五个点4.1 日期格子残留高亮现象是切换月份后某些本该空白的格子还留着上个月的绿色数字或粗体。原因在PrintMonthBody的清空循环只重置了文本和背景没有重置前景色和字体。解决方式是在两个清空循环里补上setForeground(Color.white)和setFont(new Font(TimesRoman, Font.BOLD, 12))保证每个格子每次渲染前都回到初始样式。4.2 文件读取顺序导致异常吞掉现象是第一次打开某天日记时控制台没有报错但界面也没提示“无记录”。原因是ReadRecord先构造FileReader再判断文件是否存在文件不存在时直接进catch而catch里只写了CenterText.setText(Today has not logs.)把真实异常信息丢了。解决方式是先myfile.exists()判断不存在就直接提示并返回存在再构造流catch里打印ex.getMessage()方便排查。4.3 删除文件依赖系统命令现象是在非 Windows 环境或者路径含空格时删除按钮点了没反应。原因是Runtime.exec(cmd /c del filepath)把平台和路径都写死了。解决方式是改用File.delete()返回布尔值判断成功与否再弹对应提示。这个改动同时去掉了对IOException的依赖代码更短也更稳。4.4 月份缩写拼写错误现象是 10 月的日记存成了Qct而不是Oct导致按日期找文件时对不上。原因是SwitchMonth的switch里手写字符串case 10写成了Qct。解决方式是改用String[] months {Jan,Feb,...}数组查表或者直接用java.time.Month.of(month).name()取前三位从根上消除手写拼写风险。4.5 年份输入非数字导致崩溃现象是在年份输入框里敲了字母再点查询程序直接抛异常。原因是Integer.parseInt(YearText.getText())没有做校验。解决方式是在解析前用try-catch包住NumberFormatException捕获后弹提示并把输入框重置为当前年份。更细一点的做法是用JFormattedTextField限制只能输入数字但课设阶段加个try-catch就够交差了。5. 验收与答辩怎么把这份源码讲成一份完整方案验收这份课设我一般不看代码行数看三件事能不能当场演示日历能不能正确翻月翻年、闰年二月是不是 29 天、日记能不能存了再读回来。答辩前建议自己走一遍固定用例选 2024 年 2 月看是不是 29 天选 2023 年 2 月看是不是 28 天在 1 月 1 日和 12 月 31 日各存一条日记再切走切回确认能读出来。这三组用例覆盖了日期算法、边界月份和文件读写三条主链路演示时按顺序点节奏很稳。讲的时候按“需求—设计—实现—验证”四段走每段控制在两分钟内。需求段说清楚“为什么把日历和记事本放一起”——看日期和记事情是同一个场景下的连续动作分开两个工具反而多一步切换。设计段指着界面讲JSplitPane的左右分栏和GridLayout(7,7)的 42 格说明为什么固定 42 格而不是动态生成。实现段挑GetStartDay和WriteRecord两个方法展开前者讲日期链路后者讲文件命名规则。验证段直接跑上面三组用例跑完补一句“删除功能我改成了File.delete()因为原来的系统命令跨平台会失效”这一句能体现你做过排查比背代码管用。验收项操作预期结果闰年二月查询 2024 年 2 月显示 29 天2 月 29 日可选中平年二月查询 2023 年 2 月显示 28 天3 月 1 日前无残留跨月切换连续点上一月/下一月标题、格子、选中日期同步更新日记存取选中某日写入内容并保存切走再切回内容原样读回删除确认点删除并确认文件消失界面提示删除成功答辩时被问到“为什么不用java.time”别慌就答“课设要求手写日期算法java.time我了解LocalDate.lengthOfMonth()和getDayOfWeek()能替代这三个方法但那样就练不到取模和累加了”。被问到“单类是不是太臃肿”答“是正式项目我会拆成CalendarPanel、DiaryPanel、DateUtil三个类课设阶段优先保证单文件可运行”。这两个回答既承认了局限又展示了你知道更好的做法。从那以后我每次带课设答辩都强制自己先按验收表跑一遍再上台因为血泪经验是代码能跑和演示能过是两回事中间差的就是那几组边界用例。希望这份拆解能帮到你把手里那份源码讲成一份站得住的方案。本文还有配套的精品资源点击获取