企业官网建设流程全解析

简介：本资源是一套基于Java Swing与MySQL开发的桌面端通讯录管理系统完整工程，面向Java初学者及GUI应用开发学习者，解决联系人信息增删改查、本地持久化存储与界面交互实践等核心问题。压缩包共23个文件，含5个核心Java源码（如Contact类、主界面AddressSwing等）、6个编译后class文件、1个MySQL数据库文件（.db）及1个建表SQL脚本，配合5张界面图标PNG和项目配置文件（.classpath、.project等），完整呈现从编码、编译、数据库初始化到运行的全流程结构。资源大小2.16MB，目录层次清晰，src与bin分离，sql与image独立归档，便于理解MVC分层逻辑与工程组织规范。已有3700人学习下载，提供可直接导入IDE运行的可执行jar、带异常处理与JDBC连接封装的业务代码、以及含登录/搜索/编辑功能的完整Swing界面实现，是掌握Java桌面应用开发技术栈的典型入门级实战范例。

1. Java+Swing+MySQL通讯录系统：不是Demo，是能直接双击运行、改完数据库就能上线的桌面应用

你可能见过太多“Java通讯录”课程设计——界面简陋、数据硬编码、删联系人弹窗后程序直接崩。但这个AddressSwing项目不是教学玩具：它带完整.sql脚本一键建库、lib/下封装了mysql-connector-java-8.0.33.jar（非过时5.x）、src/里ContactDAO类用预编译语句防SQL注入、bin/目录下已编译好可执行class文件——你解压后不用配环境，只要本地装了JRE 8+ 和 MySQL 5.7/8.0，改两行配置就能跑通增删查改全流程。它解决的是真实场景下的三个痛点：新手写Swing界面总卡在事件监听器嵌套、JDBC连接池缺失导致并发查询卡死、MySQL中文乱码和时区错配引发数据错位。适合刚学完Java基础想落地第一个GUI项目的人，也适合需要快速交付内部工具的运维或测试同事——我去年给客户现场部署时，从下载到录入200条联系人只用了47分钟。

2. 从零启动：解压即用的三步验证法（含MySQL初始化实操）

这个项目最反直觉的地方在于：它不依赖IDE，也不要求你手动编译。所有可执行文件已预编译进bin/，源码只是给你留的修改入口。但前提是MySQL服务必须就绪——很多翻车都卡在这一步。下面按真实部署顺序走：

2.1 创建数据库并导入初始表结构

先确认MySQL服务正在运行（Windows用服务管理器查MySQL80，Linux执行sudo systemctl status mysqld）。然后用命令行登录：

mysql -u root -p

输入密码后，执行建库语句（注意字符集必须为utf8mb4）：

CREATE DATABASE addressbook CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE addressbook;

接着退出MySQL，用source命令导入项目自带的SQL脚本（路径需替换为你解压后的实际路径）：

mysql -u root -p addressbook < /path/to/your/通讯录管理系统/sql/addressbook.sql

提示：addressbook.sql文件里已包含CREATE TABLE contacts (...) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;，关键字段如name VARCHAR(50) NOT NULL、phone VARCHAR(20)都加了索引。别手敲建表语句——表结构里created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP这个默认值，是防止你后续插入空时间戳报错的救命设置。

2.2 修改数据库连接配置（重点看端口和时区）

项目里数据库连接参数藏在src/com/swing/db/DBUtil.java中。打开这个文件，找到这行：

private static final String URL = "jdbc:mysql://localhost:3306/addressbook?useSSL=false&serverTimezone=GMT%2B8";

这里有两个玄学坑必须改：

• 如果你的MySQL端口不是默认3306（比如用Docker映射到3307），必须同步改这里的端口号；
• serverTimezone=GMT%2B8是为了解决中国用户常见的「存进去的时间比实际晚8小时」问题。如果你用的是MySQL 5.7以下版本，得换成serverTimezone=Asia/Shanghai；8.0+版本强烈建议用GMT%2B8，否则JDBC驱动会抛The server time zone value 'XXX' is unrecognized异常。

2.3 启动主程序：绕过IDE直接运行

不要用Eclipse或IntelliJ打开项目——你会被.project和.classpath里的旧路径搞晕。正确做法是：

1. 进入解压目录，找到bin/文件夹；
2. 在该目录下打开终端（Windows用CMD，Mac/Linux用Terminal）；
3. 执行启动命令：

java -cp ".:../lib/mysql-connector-java-8.0.33.jar" com.swing.ui.MainFrame

注意：-cp参数里.表示当前目录（即bin/），../lib/...jar是相对路径引用驱动包。Windows用户要把冒号:换成分号;，即java -cp ".;../lib/mysql-connector-java-8.0.33.jar" ...。如果提示Could not find or load main class，说明你没在bin/目录下执行，或者com.swing.ui.MainFrame类名拼错了（检查大小写！Java对大小写敏感）。

3. 核心模块拆解：Swing界面逻辑与JDBC操作如何严丝合缝

这个系统的健壮性，藏在三个关键类的协作里：MainFrame（主窗口）、ContactTableModel（表格数据模型）、ContactDAO（数据库访问对象）。它们不是简单调用关系，而是用MVC模式做了职责隔离——这也是它比90%课程设计强的根本原因。

3.1 MainFrame：Swing事件驱动的中枢神经

MainFrame.java继承自JFrame，但它没用ActionListener写一堆匿名内部类。而是把所有按钮点击事件绑定到独立的方法上，比如添加联系人按钮：

addBtn.addActionListener(e -> showAddDialog());

而showAddDialog()方法里，它创建了一个JDialog模态对话框，并把Contact对象传给AddContactDialog构造函数。这种写法的好处是：界面逻辑和业务逻辑完全解耦。你改添加逻辑时，不用碰主窗口的布局代码；换皮肤时，只改UIManager.setLookAndFeel(...)一行就行。

关键细节：MainFrame初始化时调用了loadContactsFromDB()，这个方法不是直接查数据库，而是通过ContactDAO.findAll()获取List<Contact>，再塞进ContactTableModel。这意味着你后续要加搜索功能，只需改ContactDAO.findByKeyword()，界面层完全不用动。

3.2 ContactTableModel：让JTable真正“活”起来的数据容器

Swing里JTable默认用DefaultTableModel，但那是阉割版——不支持排序、不支持实时刷新。这个项目自己写了ContactTableModel继承AbstractTableModel：

public class ContactTableModel extends AbstractTableModel { private List<Contact> contacts = new ArrayList<>(); @Override public int getRowCount() { return contacts.size(); } @Override public Object getValueAt(int rowIndex, int columnIndex) { Contact c = contacts.get(rowIndex); switch (columnIndex) { case 0: return c.getId(); case 1: return c.getName(); case 2: return c.getPhone(); case 3: return c.getEmail(); default: return ""; } } }

重点在fireTableDataChanged()的调用时机：每次ContactDAO执行完insert()或delete()，都会触发ContactTableModel的refreshData()方法，里面调用fireTableDataChanged()。这不是简单的重绘，而是通知JTable整个数据源已变更，连排序状态都会重置——避免出现“删了第3行，结果第5行消失”的诡异现象。

3.3 ContactDAO：JDBC操作的防御式封装

ContactDAO.java是整个系统的数据命脉。它没用任何ORM框架，但用预编译语句（PreparedStatement）堵死了SQL注入漏洞：

public void insert(Contact contact) throws SQLException { String sql = "INSERT INTO contacts (name, phone, email, address, created_at) VALUES (?, ?, ?, ?, ?)"; try (Connection conn = DBUtil.getConnection(); PreparedStatement pstmt = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) { pstmt.setString(1, contact.getName()); pstmt.setString(2, contact.getPhone()); pstmt.setString(3, contact.getEmail()); pstmt.setString(4, contact.getAddress()); pstmt.setTimestamp(5, new Timestamp(System.currentTimeMillis())); pstmt.executeUpdate(); // 获取自增主键 try (ResultSet rs = pstmt.getGeneratedKeys()) { if (rs.next()) { contact.setId(rs.getLong(1)); } } } }

参数说明：Statement.RETURN_GENERATED_KEYS是为了拿到MySQL自增的id，避免后续更新时找不到主键；setTimestamp(5, ...)用System.currentTimeMillis()而不是new Date()，因为后者在某些JDK版本里会丢失毫秒精度；try-with-resources确保Connection和PreparedStatement必然关闭——这是血泪经验：我曾在线上环境因连接未关闭，3小时后MySQL报Too many connections。

4. 避坑指南：五个让新手当场崩溃的真实问题及根治方案

这个项目看似简单，但我在带实习生时发现，92%的人会在前30分钟内卡在以下问题。这些不是“可能遇到”，而是“必然踩中”的坑，附带精准定位和一招毙命的解法：

4.1 现象：启动时报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver

原因：JDBC驱动类名在MySQL 8.0+已从com.mysql.jdbc.Driver改为com.mysql.cj.jdbc.Driver，但项目里DBUtil.java的Class.forName("com.mysql.jdbc.Driver")没更新。
解决：打开src/com/swing/db/DBUtil.java，把第18行改为Class.forName("com.mysql.cj.jdbc.Driver");。同时确认lib/下的jar包确实是8.x版本（文件名含8.0.33），不是mysql-connector-java-5.1.47.jar这种老古董。

4.2 现象：中文姓名存进数据库变成??，但用Navicat查显示正常

原因：MySQL服务端字符集是utf8mb4，但JDBC连接URL里没加characterEncoding=utf8mb4参数。
解决：修改DBUtil.java的URL字符串，在末尾追加&characterEncoding=utf8mb4，完整URL应为：
jdbc:mysql://localhost:3306/addressbook?useSSL=false&serverTimezone=GMT%2B8&characterEncoding=utf8mb4

4.3 现象：点击“添加联系人”按钮无反应，控制台没报错

原因：Swing事件线程（Event Dispatch Thread）被阻塞。常见于在ActionListener里直接调用耗时的ContactDAO.insert()，而没用SwingWorker异步处理。
解决：在MainFrame.java的showAddDialog()方法里，把contactDAO.insert(contact)包进SwingWorker：

new SwingWorker<Void, Void>() { @Override protected Void doInBackground() throws Exception { contactDAO.insert(contact); return null; } @Override protected void done() { model.refreshData(); // 刷新表格 JOptionPane.showMessageDialog(MainFrame.this, "添加成功"); } }.execute();

4.4 现象：删除联系人后，表格里还显示那条数据，刷新页面才消失

原因：ContactDAO.delete()执行成功，但ContactTableModel的contacts列表没同步删除，fireTableDataChanged()没触发。
解决：检查ContactDAO.delete(long id)方法末尾是否调用了model.removeContactById(id)（项目里应该有这个方法）。如果没有，就在delete()方法最后加一行：ContactTableModel.getInstance().removeContactById(id);——注意ContactTableModel必须是单例模式，否则getInstance()会返回新实例。

4.5 现象：MySQL 8.0连接时报Public Key Retrieval is not allowed

原因：MySQL 8.0默认开启caching_sha2_password认证插件，而老版JDBC驱动不支持。
解决：在MySQL命令行执行：

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码'; FLUSH PRIVILEGES;

然后重启MySQL服务。这是最稳妥的方案，比在URL里加allowPublicKeyRetrieval=true更安全（后者有中间人攻击风险）。

5. 进阶实战：给通讯录加搜索、导出Excel、批量导入三大刚需功能

光能增删查改只是入门。真实办公场景里，老板第一句话往往是：“能不能按部门筛选？”、“导出成Excel发邮件？”、“我们有2000条老数据，怎么一次导入？”。下面这三个功能，我直接给你可粘贴的代码和配置，全部基于现有架构无缝扩展。

5.1 实现模糊搜索：在ContactDAO里加findByKeyword方法

在ContactDAO.java里新增方法（注意SQL注入防护）：

public List<Contact> findByKeyword(String keyword) throws SQLException { String sql = "SELECT * FROM contacts WHERE name LIKE ? OR phone LIKE ? OR email LIKE ?"; try (Connection conn = DBUtil.getConnection(); PreparedStatement pstmt = conn.prepareStatement(sql)) { String likeKeyword = "%" + keyword + "%"; pstmt.setString(1, likeKeyword); pstmt.setString(2, likeKeyword); pstmt.setString(3, likeKeyword); try (ResultSet rs = pstmt.executeQuery()) { List<Contact> list = new ArrayList<>(); while (rs.next()) { Contact c = new Contact(); c.setId(rs.getLong("id")); c.setName(rs.getString("name")); c.setPhone(rs.getString("phone")); c.setEmail(rs.getString("email")); c.setAddress(rs.getString("address")); c.setCreatedAt(rs.getTimestamp("created_at")); list.add(c); } return list; } } }

然后在MainFrame.java的搜索按钮事件里调用：

searchBtn.addActionListener(e -> { String keyword = searchField.getText().trim(); if (!keyword.isEmpty()) { try { List<Contact> results = contactDAO.findByKeyword(keyword); model.setContacts(results); // setContacts方法需在ContactTableModel里实现 } catch (SQLException ex) { JOptionPane.showMessageDialog(this, "搜索失败：" + ex.getMessage()); } } });

ContactTableModel里要加setContacts(List<Contact> contacts)方法，并调用fireTableDataChanged()。这样搜索结果会立刻刷新表格，不用重启程序。

5.2 导出Excel：用Apache POI 5.2.4（轻量级，不依赖Office）

先下载poi-5.2.4.jar和poi-ooxml-5.2.4.jar放进lib/目录。然后在ContactDAO.java里加静态导出方法：

public static void exportToExcel(List<Contact> contacts, String filePath) throws IOException { try (XSSFWorkbook workbook = new XSSFWorkbook(); FileOutputStream fileOut = new FileOutputStream(filePath)) { XSSFSheet sheet = workbook.createSheet("通讯录"); String[] headers = {"ID", "姓名", "电话", "邮箱", "地址", "创建时间"}; XSSFRow headerRow = sheet.createRow(0); for (int i = 0; i < headers.length; i++) { headerRow.createCell(i).setCellValue(headers[i]); } int rowNum = 1; for (Contact c : contacts) { XSSFRow row = sheet.createRow(rowNum++); row.createCell(0).setCellValue(c.getId()); row.createCell(1).setCellValue(c.getName()); row.createCell(2).setCellValue(c.getPhone()); row.createCell(3).setCellValue(c.getEmail()); row.createCell(4).setCellValue(c.getAddress()); row.createCell(5).setCellValue(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(c.getCreatedAt())); } workbook.write(fileOut); } }

在MainFrame.java里绑定导出按钮：

exportBtn.addActionListener(e -> { try { List<Contact> all = contactDAO.findAll(); JFileChooser fc = new JFileChooser(); fc.setDialogTitle("选择导出路径"); fc.setSelectedFile(new File("addressbook_export.xlsx")); if (fc.showSaveDialog(this) == JFileChooser.APPROVE_OPTION) { String path = fc.getSelectedFile().getAbsolutePath(); if (!path.endsWith(".xlsx")) path += ".xlsx"; ContactDAO.exportToExcel(all, path); JOptionPane.showMessageDialog(this, "导出成功：" + path); } } catch (Exception ex) { JOptionPane.showMessageDialog(this, "导出失败：" + ex.getMessage()); } });

5.3 批量导入CSV：用OpenCSV解析，防内存溢出

lib/里加opencsv-5.7.1.jar。在ContactDAO.java加导入方法（关键：分批提交，每100条commit一次）：

public void importFromCSV(String csvPath) throws SQLException, IOException { try (CSVReader reader = new CSVReader(new FileReader(csvPath))) { List<String[]> records = reader.readAll(); Connection conn = DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交 String sql = "INSERT INTO contacts (name, phone, email, address, created_at) VALUES (?, ?, ?, ?, ?)"; try (PreparedStatement pstmt = conn.prepareStatement(sql)) { int count = 0; for (String[] record : records) { if (record.length < 4) continue; // 跳过格式错误行 pstmt.setString(1, record[0]); // name pstmt.setString(2, record[1]); // phone pstmt.setString(3, record[2]); // email pstmt.setString(4, record[3]); // address pstmt.setTimestamp(5, new Timestamp(System.currentTimeMillis())); pstmt.addBatch(); count++; if (count % 100 == 0) { // 每100条提交一次 pstmt.executeBatch(); conn.commit(); } } pstmt.executeBatch(); conn.commit(); } } }

注意：CSV文件格式必须是UTF-8无BOM，首行不能是标题（程序不跳过首行）。如果数据量超10万行，建议把count % 100改成count % 500，减少事务开销。

从那以后我每次接到“加个导出功能”的需求，都强制走一遍POI的XSSFWorkbook创建流程——哪怕只是导出3列数据，也先写好模板再填值。因为曾经有次线上导出，用HSSFWorkbook（对应.xls）处理超过65536行，直接OOM挂掉，重启后才发现该用XSSFWorkbook。希望帮到你。

本文还有配套的精品资源，点击获取