《Java 编程实战》4.1 表设计:约束、范式与 libraryd 的 schema
数据库 schema 是 libraryd 的最终契约,也是应用层之外的最后一道校验。本节逐条解释 V1__init.sql 里的三张表、主外键、检查约束和部分唯一索引,并用真实插入失败验证每条规则挡住的是什么错误,以及哪些规则不该交给应用层,哪些又必须留给数据库。
category
数据库 schema 是 libraryd 的最终契约,也是应用层之外的最后一道校验。本节逐条解释 V1__init.sql 里的三张表、主外键、检查约束和部分唯一索引,并用真实插入失败验证每条规则挡住的是什么错误,以及哪些规则不该交给应用层,哪些又必须留给数据库。
SQL 散落在服务层会让事务、错误码和测试都变得难以收口。本节把图书、会员、借阅三类 SQL 收进 JdbcBookRepository、JdbcMemberRepository 与 JdbcLoanRepository,用行映射还原 record,并把 SQLState 翻译成 libraryd 的 ErrorCode。
每条请求都新建物理连接会拖慢 libraryd,也很快耗尽 PostgreSQL 的连接数。本节用 HikariCP 建立有界连接池,讲清 maximumPoolSize、connectionTimeout、maxLifetime 与 leakDetectionThreshold 的含义,并用真实日志定位连接泄漏和池耗尽。
libraryd 从内存仓储走向 PostgreSQL,第一步是把 JDBC 的四个对象用对:DriverManager 与 DataSource 的取舍、PreparedStatement 的参数绑定、ResultSet 的列读取,以及生成键与资源关闭。本节用真实容器跑通图书和借阅记录的写入与查询。
把测试从「跑过」变成「可验收」:用 JaCoCo 的 LINE 与 BRANCH 计数读懂报告,按模块设置 60% 行覆盖率门槛,在 quality profile 里串起编译、测试、Checkstyle、SpotBugs 和覆盖率,最后落到一条 CI 命令。
区分 Checkstyle 管源码风格、SpotBugs 管字节码缺陷:给出一份只保留命名、导入、大括号和魔法数字的精简规则集,用真实违规输出解释阈值与抑制范围,再用 CT_CONSTRUCTOR_THROW 说明 SpotBugs 的第一条告警为什么把异常类声明为 final 就能修复。
把 javac 的 -Xlint 从编辑器提示变成构建门禁:先看 rawtypes 与 unchecked 的真实告警,再用 maven-compiler-plugin 的 -Xlint:all,-processing 加 -Werror,最后给出 libraryd 里处理泛型与受检异常的写法。
按报错关键词整理 Java 入门阶段最常见的编译与运行问题:找不到符号、类型不兼容、找不到主类、类版本不匹配、NoSuchMethodError、空指针、数组越界、并发修改、编码乱码、Maven 依赖冲突、jar 无法运行、端口占用等,每条给出典型报错、原因、排查步骤与修复示例。
让同一 commit 在任何机器上产出相同字节:锁定 Maven 生命周期插件版本,设置 project.build.outputTimestamp,连续两次 clean package 比较 jar 的 SHA-256,并说明 SNAPSHOT、时区与本地缓存会怎样破坏可复现性。
把 JDK 21 到 25 的正式特性与预览特性分开列清楚:21 的虚拟线程、记录模式、switch 模式匹配,22 的 FFM API 与未命名变量,23 的 Markdown 文档注释与分代 ZGC 默认,24 的 Class-File API 与 Stream Gatherers,25 的 Scoped Values、模块导入声明、紧凑源文件、灵活构造器与紧凑对象头,并给出迁移建议。
把散落在子模块里的版本号收回父 POM:用 dependencyManagement 与 Jackson BOM 统一版本,用 runtime、test 作用域收紧依赖,再用 Enforcer 的 dependencyConvergence 抓出 Javalin 与 Jedis 带来的真实冲突并收敛。
按包梳理 java.base 与常用 JDK 模块:java.lang、java.util、java.io、java.nio.file、java.time、java.net.http、java.util.concurrent、java.util.regex 等各自负责什么、关键类有哪些、什么时候该用,并给出按任务选包的速查表。
把卷一的单模块 library 拆成 domain、persistence、web、app、integration-tests 五个模块:先按变化频率和依赖方向划边界,再写出可编译的父 POM、子模块 POM 与最小骨架,最后用 Maven reactor 和依赖树验证拆分结果。
把《Java 编程入门》涉及的语法压缩成一页可查的速查表:基本类型、变量、运算符、控制流、方法、类与接口、record/enum/sealed、泛型、集合、Stream、异常、NIO、java.time、正则,以及常用的 javac/java/mvn 命令,每项都配最小示例。
不引入任何 Web 框架,用 JDK 自带的 com.sun.net.httpserver 把 LibraryService 暴露成 REST:手写扁平 JSON、实现 GET /books、POST /books、POST /loans、POST /returns,并用 curl 验证 201、409 等真实响应。
给 library 接上存储和交互:用 LibraryRepository 接口隔离存储,用 TreeMap 与活动借阅表实现内存仓储,再让 CommandParser 解析 add、list、borrow、return、search、quit 六个命令,最后用真实终端会话跑通借阅与归还。
把前 17 章的能力收束成一个完整项目:先划清 library 的需求边界,再用 Book、Member、Loan 三个 record 和 LibraryService 的借阅、归还方法,把「一本书同时只能借给一个人、借期 14 天、逾期按天计费」写成可执行的领域规则。
把 library 的构建从「我这儿能打包」推进到「谁都能复现」:用 outputTimestamp 固定 jar 条目时间,用固定依赖、BOM 和 enforcer 禁止动态版本,再用 sha256、dependency:tree 与离线构建验证发布产物。
把 library 的 class 文件打成可直接运行的 jar:读懂 jar 与 MANIFEST.MF,用 maven-jar-plugin 写 Main-Class,比较依赖复制与 maven-shade-plugin 的取舍,再补上 module-info、jar --describe-module、jdeps 与 jlink 的完整命令和真实输出。
从 library 的 JUnit 测试依赖出发,讲清 Maven 坐标、传递依赖与 compile、test、provided、runtime 四种作用域的实际影响;再用真实的依赖树、冲突裁决记录和 NoClassDefFoundError,说明最近优先、dependencyManagement 与 BOM 的用法。