JavaWeb Day04：条件分页、事务新增与本地上传

代码结构#

核心结论#

1. POJO 对象收参：多个查询参数（page/pageSize/name/gender/begin/end）收进一个 EmpQueryParam，@DateTimeFormat 解决 LocalDate 字符串绑定；接口签名变干净，也便于复用，是分页+条件查询接口的标准做法。
2. PageHelper 分页 = 插件物理分页：startPage 把分页参数放进 ThreadLocal，MyBatis 拦截器在执行 SQL 前重写语句，按方言追加 limit（物理分页，效果与手写 LIMIT 一致，省去两步手写）；查询后强转 Page 取 total/result。强转依赖 PageHelper 返回的代理对象，普通 List 不能这么转。
3. @Transactional(rollbackFor = Exception.class)：默认只对 RuntimeException/Error 回滚，Checked Exception 会静默提交；显式 rollbackFor 把范围扩到全部 Exception，防止 SQL/IO/自定义异常写入脏数据。
4. useGeneratedKeys 主键回填：@Options(useGeneratedKeys=true, keyProperty="id") 让数据库自增主键写回 emp.id，新增后立即能拿到新 id，才能给工作经历设置 empId 外键；批量插入的主键回填同理。
5. finally 记日志的事务伏笔：save 的 finally 里调用 empLogService.insertLog（未设独立传播级别），日志插入与 save 同处一个事务——业务一旦回滚，日志也一起回滚消失。解决思路是给日志方法指定事务传播行为 REQUIRES_NEW，让它在独立事务中提交。
6. 上传防坑三件套：目录先建（mkdirs）→ UUID 唯一名（防重名覆盖、中文乱码与路径穿越，绝不拼用户原文件名）→ transferTo 落盘；集群场景改为读 InputStream 推送对象存储。

踩坑与注意#

• PageHelper 强转 (Page<Emp>) list 依赖插件的代理返回值，对普通 List 强转会抛 ClassCastException——分页必须走 startPage 之后的第一条查询。
• expr.setEmpId(emp.getId()) 必须发生在 insert 之后（主键回填完成后），顺序反了拿不到 id。
• 上传失败被 catch 后仍返回 success()，异常被吞掉——可用全局异常处理器统一返回错误响应。