简介基于Java开发的通讯录管理系统完整项目源码面向正在学习Java面向对象与GUI编程的初学者尤其适合作为课程设计或自学练手的入门案例通过联系人信息的管理与维护帮助理解类、对象、继承、封装、多态等核心概念。资源包共16个文件包含6个Java源文件与10个编译后的class文件压缩包大小仅20KB适合直接导入开发环境运行或对照学习。项目实现了联系人的添加、查找、修改、删除并设计了登录验证和用户界面覆盖Swing界面布局、集合框架存储、文件读写与数据库连接等关键知识点可借助源码梳理从窗口构建到事件响应、从数据封装到持久化存储的完整流程。已有696人学习下载对于希望以小型项目巩固Java基础、完成课程设计或了解桌面应用开发流程的学习者这套源码提供了清晰可读的实践范本。 说实话很多人的Java学习路线里都有一道绕不开的坎通讯录管理系统。它看起来就是个“新手村任务”增删改查罢了但真正要把CRUD、界面交互、数据持久化、异常处理这些点串起来还要让代码经得起答辩、面试的追问就不只是抄一份几百行的Demo能解决的事了。这篇文章我就拿这个经典项目来拆一拆从技术选型、建表设计、JDBC连接到业务逻辑、Swing界面的坑再到面试时怎么把项目讲出彩一条线捋完。适合正在做课程设计的学生也适合想用手写项目巩固Java基础的自学者。你手里的“通讯录管理系统java”完全可以从“能跑”做到“能讲清楚为什么这么做”。1. 项目定调通讯录管理系统应该怎么做1.1 功能清单哪些是基础项哪些是加分项先别急着写代码把功能边界划清楚。一个标准的通讯录管理系统核心功能一般就这几块联系人管理新增、修改、删除、查看详情分组管理家庭、同事、朋友等分组联系人可以归属到某个分组搜索按姓名、手机号、邮箱做模糊查询数据持久化程序重启后数据不丢附加功能导入导出CSV、联系人查重、统计人数。很多同学做这个项目最大的问题不是功能太简单而是“什么功能都想要”。比如加个短信群发、加个电话拨号结果技术难度瞬间上去做不完还容易出bug。我的建议是基础功能做到位再挑一个加分项做到“能讲清楚原理”就比功能堆砌但一问三不知强得多。1.2 技术方案选型SwingJDBC还是Spring Boot我看过很多人一上来就问“要不要用Spring Boot”。这里得先看你的场景。方案技术栈适合场景优点缺点方案AJavaSE Swing JDBC MySQL课程设计、答辩逻辑直观贴合Java基础界面丑代码量大方案BJavaSE 文件序列化存储纯Java基础练手不依赖数据库环境简单查询、扩展麻烦方案CSpring Boot Thymeleaf MyBatis自学进阶、做Web项目企业技术栈、面试加分学习成本高偏离“基础”主题如果你是在校生课程设计大多数情况下选方案A最稳。Swing虽然老了点但桌面程序的效果展示直观老师能直接看到运行界面和数据库数据。如果你已经是自学Java几个月、准备找实习那方案C会更有价值因为开发模式贴近企业项目。我个人的观点是哪怕你最后选了方案C也最好先在方案A上把“Java是怎么连接数据库、怎么把数据映射成对象”这件事搞清楚。不然Spring Boot一封装很多细节会被吞掉面试官一问底层就露馅。2. 数据层设计建表与JDBC连接的核心细节2.1 表结构设计为什么联系人要挂到分组表下数据库设计是很多刚学Java的人最容易忽略的部分。有些人图省事建一张表把分组名直接写成一个字段比如group_name VARCHAR(20)。这样确实简单但隐藏问题很大分组名一旦要改名所有联系人的数据都要跟着改想统计“每个组有多少人”SQL写起来也别扭。更规范的做法是拆两张表CREATE TABLE t_group ( id INT PRIMARY KEY AUTO_INCREMENT, group_name VARCHAR(50) NOT NULL UNIQUE, remark VARCHAR(200) ); CREATE TABLE t_contact ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, gender CHAR(1) DEFAULT 男, phone VARCHAR(20), email VARCHAR(100), address VARCHAR(200), group_id INT, create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP, update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, CONSTRAINT fk_contact_group FOREIGN KEY (group_id) REFERENCES t_group(id) );联系人表里存group_id而不是group_name是用外键把一个联系人关联到分组这样数据一致性有保障后面做“按分组筛选联系人”时一条SQL就搞定了。当然课程设计阶段外键加了容易踩“删除分组但组里还有人”的问题所以删除前要判断组内是否有关联联系人。2.2 JDBC连接驱动类找不到和时区报错的解法JDBC是Java连接数据库的根基。很多人的项目跑不起来问题都出在连接这一步。这里直接给一段能用的标准代码private static final String URL jdbc:mysql://localhost:3306/address_book?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8; private static final String USER root; private static final String PASSWORD 123456; public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); }几个容易踩的点MySQL 8的驱动类是com.mysql.cj.jdbc.Driver不是老的com.mysql.jdbc.Driver旧写法会报ClassNotFoundExceptionURL里必须带上serverTimezoneAsia/Shanghai否则会报“The server time zone value”之类的错useSSLfalse是关闭SSL警告学习阶段不需要加密连接记得在pom.xml或项目的lib目录里引入mysql-connector-java版本要和MySQL版本匹配。操作数据库时一定要用PreparedStatement而不是Statement。一方面防SQL注入比如用户在搜索框输入 OR 11 --这种内容时Statement拼接字符串会把你的查询条件全部绕过另一方面PreparedStatement有预编译参数用?占位代码可读性也更好。2.3 程序员的偷懒方案不用MySQL用文件持久化如果环境里装不了MySQL或者你就是想练习Java I/O那文件持久化也可以。思路很简单把ArrayListContact整体序列化到本地文件。// 保存 try (ObjectOutputStream oos new ObjectOutputStream(new FileOutputStream(data.dat))) { oos.writeObject(contactList); } catch (IOException e) { e.printStackTrace(); } // 读取 try (ObjectInputStream ois new ObjectInputStream(new FileInputStream(data.dat))) { contactList (ListContact) ois.readObject(); } catch (IOException | ClassNotFoundException e) { e.printStackTrace(); }前提是Contact类要实现Serializable接口。这种做法启动快、代码少但数据只能被这个程序自己读不方便做条件查询、统计也不方便给别人对接。所以我的建议是能装MySQL就首选MySQL文件持久化作为备选方案答老师提问时可以说“我在学习JDBC之前先用文件存储做了数据持久化的版本”。3. 业务逻辑实现CRUD、搜索和导入导出的关键技术3.1 分层架构entity、dao、service、view怎么划分别把业务代码全塞进界面事件里。虽然项目小但分层的习惯要养起来这也是面试中的高频考察点。最简单的划分方式entity实体类对应数据库表字段就是表的列dao数据访问层负责和数据库打交道比如ContactDao里有insert、update、deleteById、findAll、search等方法service业务逻辑层负责校验、组合操作比如新增联系人时检查手机号格式、查重view界面层Swing窗口只负责展示和接收用户操作拿到数据交给service处理。这样分层的好处是界面改动不影响数据库代码换一个界面实现比如Swing换成控制台也只需要改view层。面试时你能说出“我是按单一职责拆分的DAO管数据、Service管业务、View管交互”这个项目就比“我写了个监听器直接查库”高一个档次。3.2 模糊查询与排序从Stream过滤到Comparator实战按姓名模糊搜索最简单的是SQL层面的LIKEString sql SELECT * FROM t_contact WHERE name LIKE ?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, % keyword %);注意%的位置% keyword %表示包含关键字keyword %表示以关键字开头。这个细节经常有人搞错。如果你把数据加载到了内存里也可以用Java 8的Stream来做ListContact result contactList.stream() .filter(c - c.getName().contains(keyword) || c.getPhone().contains(keyword)) .collect(Collectors.toList());排序是另一个高频考点。比如按姓名排序ListContact list contactDao.findAll(); list.sort(Comparator.comparing(Contact::getName));这是Comparator Lambda的写法考的就是java.util.Comparator和函数式接口。面试时如果被问“你项目里有没有用Lambda”把这段讲出来就很有说服力。当然如果你在学排序算法也可以手写个冒泡排序、快速排序给list排个序顺便把compareTo的规则搞清楚面试八股文里常考的排序题就有了真实应用场景。3.3 手机号校验、同名处理和遍历删除的经典坑新增联系人时一定要做输入校验。手机号用正则public static boolean isValidPhone(String phone) { return phone ! null phone.matches(^1[3-9]\\d{9}$); }这不是在“折腾用户”而是保证数据库里不存脏数据。否则一个phone字段有的是11位、有的是10位后面查询和统计都会出问题。同名联系人怎么处理我的做法是允许保存但新增时提示“联系人中已有同名人员”。这样既不影响真实场景同名很常见又能体现你考虑到了业务规则。删除是另一个容易出事的操作。最经典的坑就是在循环遍历ArrayList时直接removefor (int i 0; i list.size(); i) { if (条件) { list.remove(i); // 索引会变化可能越界或漏删 } }正确做法是使用迭代器的remove方法或者直接用Java 8的removeIflist.removeIf(contact - contact.getId() targetId);面试八股文里常出现的“数组越界异常”在项目里这是最真实的触发场景之一。能讲清楚“为什么倒着删也行、为什么for-each里不能用list.remove”比背十道题都管用。3.4 导出CSV解决中文乱码和逗号转义导出联系人到CSV文件是很多课程设计的加分项但十个有八个会栽在中文乱码上。原因很简单CSV默认用文本方式打开Excel打开时如果没识别出UTF-8编码中文就会乱。解决办法是输出UTF-8 BOM头StringBuilder sb new StringBuilder(); sb.append(\uFEFF); // BOM头 sb.append(姓名,手机号,邮箱,分组\n); for (Contact c : list) { sb.append(c.getName()).append(,) .append(c.getPhone()).append(,) .append(c.getEmail()).append(,) .append(c.getGroupName()).append(\n); } Files.write(Paths.get(contacts.csv), sb.toString().getBytes(StandardCharsets.UTF_8));还有一个细节如果联系人姓名里本来就有逗号直接拼CSV会把列挤乱。业界惯例是给含逗号或引号的字段加双引号。课程设计阶段不一定需要做这么细但能在答辩时主动说出“我考虑了字段转义”老师会认为你想得比较深。4. 界面层实现Swing控件的选择与事件处理4.1 Swing还是JavaFX课程设计选型建议界面用Swing还是JavaFX我建议按你的技术储备来。Swing是JDK自带的不用额外配置JFrame、JTable、JButton这些基础控件掌握起来很快课程设计最稳妥。JavaFX更现代、界面更美观但环境配置、FXML文件、Controller逻辑学习曲线会陡一些。如果你不想花太多时间在界面上Swing足够。布局就用BorderLayout顶部放搜索栏中间放JTable底部放按钮。加个JSplitPane或JTabbedPane做分组页签视觉效果已经不错了。界面不是这个项目的核心别把大多数时间耗在像素级调样式上。4.2 JTable刷新与窗口关闭时释放资源JTable用起来有一堆细节。最常被问到的就是“为什么增删后表格不刷新”。原因是你改了数据模型但没有通知表格重绘。JTable配合DefaultTableModel使用时刷新数据有几种方式一种是把表格数据清空后重新添加DefaultTableModel model (DefaultTableModel) table.getModel(); model.setRowCount(0); // 清空旧数据 for (Contact c : contactList) { model.addRow(new Object[]{c.getId(), c.getName(), c.getPhone(), c.getEmail()}); }注意setRowCount(0)这一步不能省不然老数据会残留在表格里。另一个细节是窗口关闭时要释放数据库连接等资源。很多人的程序在IDE里跑着没事反复开关窗口后连接数暴涨。最简单的处理是给窗口添加监听器frame.addWindowListener(new WindowAdapter() { Override public void windowClosing(WindowEvent e) { // 关闭连接池或释放资源 System.exit(0); } });如果是长连接建议用连接池管理数据库连接而不是每次操作都新建连接。HikariCP是现在比较主流的连接池配置也不复杂能在项目里用上它面试聊起来又是个加分点。4.3 扩展成Web版时的技术变化如果后期想做Web版核心变化就是把view层换成Spring MVC的Controller Thymeleaf页面dao层变成MyBatis或Spring Data JPAservice层的业务逻辑基本可以复用。我的建议是先把Swing版跑通把数据访问和业务逻辑沉淀下来。等需要做Spring Boot版本你会发现很多代码只是换了个壳思考方式完全一样。尤其是Contact实体类、ContactDao、ContactService这几层几乎可以原样搬过去。这就是分层的价值——你在课程设计里多写的那几个类不是白写的。5. 踩坑实录与面试讲项目的方法5.1 JDBC报错速查表这个项目里90%的Java新人都会在数据库连接这一步卡住。我把常见报错整理了一下报错信息原因解决方案ClassNotFoundException: com.mysql.jdbc.Driver驱动类名写错或jar包没引入换成com.mysql.cj.jdbc.Driver检查依赖Communications link failureMySQL服务没启动或端口不对确认MySQL在运行检查连接串的IP和端口The server time zone value Öйú±ê׼ʱ¼ä连接串缺时区参数加serverTimezoneAsia/ShanghaiAccess denied for user rootlocalhost用户名或密码错误检查账号密码确认权限不支持的SSL连接串缺SSL配置加useSSLfalse遇到连接问题先看最外层异常再看堆栈里Caused by后面的信息。很多时候是配置问题不是代码逻辑问题。5.2 代码层常见的5个Bug结合我自己的经验代码层这几个Bug出现频率很高实体类属性跟表字段对不上MySQL列名是create_time实体类属性是createTime如果没做映射查询结果里这个字段就是null。用ResultSet取数时要按列名取别按位置取。日期类型混乱java.sql.Date和java.util.Date混用。JDBC操作时参数用java.sql.Date或Timestamp更省事。忘记给新增的联系人设置分组数据库里group_id是外键界面没选分组时插入null导致查出来“未分组”的人都看不到。建议界面下拉框默认选中“默认分组”。修改联系人时把所有字段都更新一遍如果某字段填了空字符串应该判断是“没填写”还是“填了空值”否则会把数据库里原有的数据清空。ID自增导致的删除后索引错觉数据库自增ID不会因为删了数据就重新填坑。删除最后一个人后ID变大了这正常别纠结。5.3 面试官问这个项目时怎么答出亮点这个项目太常见了所以面试时讲法得讲究。别上来就复述“我做了增删改查”那等于没讲。我更推荐按这个顺序第一讲清楚项目解决了什么问题。通讯录管理解决的是“联系人信息分散、难维护、难查找”的问题核心诉求是信息的规范化和快速检索。第二讲清楚你做的关键设计。比如“我用分组表外键关联联系人让分组能独立维护”“我用了PreparedStatement防止SQL注入同时提高预编译效率”“我把界面、业务、数据分了三层后续换界面或换数据库改动的成本都可控”。第三讲清楚你可以怎么继续优化。比如“现在联系人搜索是LIKE模糊匹配数据量大的时候可以用全文索引”“当前是单机程序如果做成Web版会引入Spring Boot和连接池”“我可以加一个联系人生日提醒用定时任务每天扫描一次”。这些优化点都能和你平时背的Java八股文挂上钩比如集合选型、异常处理、Lambda、Stream、并发安全等项目就“活”起来了。我自己的经验是课程设计项目能让人记住的从来不是功能多炫而是你花了多少心思考虑边界情况、代码结构、异常处理和扩展性。写通讯录管理系统的过程本质上是把课本上的语法变成工程习惯的过程。哪怕只是把PreparedStatement、Comparator、try-with-resources这些点真正用对对后面学Spring Boot、做企业项目都会有很实在的帮助。本文还有配套的精品资源点击获取
