23125098+832302226_梁哲尘

x197352 2025-12-12 23:25:56

Extreme Programming: Address Book System with Bookmark, Multi-Contact, and Excel Import/Export

作业基本信息

项目所属课程	EE308FZ（软件工程），福州大学梅努斯国际工程学院
作业要求	作业链接
作业目标	通过极限编程完成一个带有收藏、导入导出、多个联系方式的通讯录系统
GitHub链接	https://github.com/lzc1c/addressbook-project
远程部署	未部署（本地运行）
学生ID	梁哲尘: (MU) 23125098 (FZU) 832302226

1. Github Commits 记录

本项目共提交 11 次 commits，其中：

梁哲尘 提交 11 次

项目采用 单仓库、前后端一体化结构（Spring Boot + Thymeleaf），所有代码均在 src/main 下管理

1.1. 主分支提交记录

![主分支提交记录]

2. 团队成员项目分工及评分

没找到队友独立完成

3. 功能实现思路描述

3.1. 技术栈

后端框架：Spring Boot 3.2.x（Java 17）
数据库：SQLite（本地文件存储）
前端模板：Thymeleaf（前后端不分离）
Excel 处理：Apache POI
构建工具：Maven
IDE：IntelliJ IDEA

⚠️ 注：因 Spring Boot 4（Hibernate 6）与 SQLite 兼容性问题复杂，我选择聚焦功能实现，未进行云部署。

3.2. 核心功能思路描述

3.2.1.1 联络人书签（25分）

实现方式：

在 Contact 实体中添加 isFavorite: Boolean 字段
查询时使用 JPA 自定义方法按收藏状态排序：

}

3.2.2 增加多个联系方式（10分）

数据模型设计：

创建 ContactMethod 实体（类型：PHONE/EMAIL/ADDRESS/SOCIAL）
Contact 与 ContactMethod 为一对多关系（@OneToMany）

前端交互：

表单中动态添加/删除联系方式行
每行包含“类型下拉框 + 内容输入框”

3.2.3. 导入和导出（25分）
导出 Excel：

使用 Apache POI 创建 .xlsx 文件
表头：姓名、是否收藏、电话、邮箱、地址、社交账号（多值用换行分隔）
控制器返回 ResponseEntity 触发浏览器下载

导入 Excel：

用户上传 .xlsx 文件
后端解析每一行，按列提取信息
对多值字段（如电话）按换行符拆分为多个 ContactMethod
批量保存到数据库

程序运行视频及截图
1. 程序运行视频

4.2. 程序运行截图
4.2.1. 主界面（含收藏星标）

收藏联系人置顶显示
多联系方式以换行形式展示
4.2.2. 新建/编辑联系人

动态增删联系方式
类型可选（电话/邮箱/地址/社交）

4.2.3. 导出 Excel

4.2.4. 导入 Excel

5. 项目开发时遇到的困难

SQLite + Spring Boot 4 兼容性问题：尝试自定义 SQLiteDialect，但 Hibernate 6 移除了旧 API，调试数小时无果，最终决定放弃部署，专注本地功能。
POI 导入多值字段解析：需处理换行符、空值、非法格式，通过正则和异常捕获增强鲁棒性。
Thymeleaf 动态表单绑定：List 绑定需使用 th:field="*{methods[${index}].value}"，初期语法错误导致数据无法回显。
前端样式统一：Thymeleaf 无组件化，重复代码多，通过抽取 fragments 解决。
AJAX 刷新局部区域：原计划整页刷新，后改用 fetch + innerHTML 实现星标实时更新。
文件上传安全校验：限制仅 .xlsx 文件，防止恶意上传。