《Java 网络编程基础》1.3 linkd 项目与实验环境
把 linkd 拆成 core、http、ws、app 四个 Maven 模块,固定 JDK 25.0.5 与 9090/8080 端口约定;给出 JAVA_HOME 设置、父 POM、启动与 curl/lsof/netstat 验证步骤,并记录 macOS 没有 ss/epoll 时的替代诊断命令。
tag
把 linkd 拆成 core、http、ws、app 四个 Maven 模块,固定 JDK 25.0.5 与 9090/8080 端口约定;给出 JAVA_HOME 设置、父 POM、启动与 curl/lsof/netstat 验证步骤,并记录 macOS 没有 ss/epoll 时的替代诊断命令。
给出一套可直接对照的 libraryd 多模块 Maven 配置:父 POM 的属性与 dependencyManagement、五个子模块的依赖声明、编译与测试插件、Enforcer、JaCoCo、Checkstyle、SpotBugs、Shade、Jib 的完整片段,以及 quality、integration 两个 profile 与常用诊断命令。
mvn package 默认只产出几十 KB 的瘦 jar,离开 Maven 就找不到依赖。本节用 Shade 3.6.2 生成可执行的 libraryd fat jar,处理 SPI 与签名文件,再用 jdeps 和 jlink 裁出 53 MB 运行时,并给出真实的 jar 大小与启动耗时。
让同一 commit 在任何机器上产出相同字节:锁定 Maven 生命周期插件版本,设置 project.build.outputTimestamp,连续两次 clean package 比较 jar 的 SHA-256,并说明 SNAPSHOT、时区与本地缓存会怎样破坏可复现性。
把散落在子模块里的版本号收回父 POM:用 dependencyManagement 与 Jackson BOM 统一版本,用 runtime、test 作用域收紧依赖,再用 Enforcer 的 dependencyConvergence 抓出 Javalin 与 Jedis 带来的真实冲突并收敛。
把卷一的单模块 library 拆成 domain、persistence、web、app、integration-tests 五个模块:先按变化频率和依赖方向划边界,再写出可编译的父 POM、子模块 POM 与最小骨架,最后用 Maven reactor 和依赖树验证拆分结果。
把 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 的用法。
把 Maven 生命周期还原成一条可执行的流水线:validate、compile、test、package、verify、install、deploy 各自做什么,为什么 mvn package 会顺带跑测试,target 下每个目录从哪来;再用 library 工程实跑 compile、test、package,检查 jar 内容与 No tests to run 的真实输出。
把 library 从单文件 javac 推进到 Maven 工程:解释 groupId、artifactId、version 与标准目录结构,逐项拆开最小 pom.xml 里的 release 与编码配置,再用 mvn compile 验证 target/classes 的产物,并列出目录放错、POM 缺失、编码未设三类常见故障。
系统讲解从 Java 渐进迁移到 Clojure 的工程路径:绞杀者模式与切入点排序、互操作边界与数据语义设计、Maven/Gradle 与 deps.edn 混合构建、AOT 与 uberjar 打包部署、团队技能矩阵与代码评审清单,以及常见陷阱与量化验收度量。
本附录对照同一件事在 Maven 与 Gradle 下的写法:项目结构与构建文件、依赖与版本管理、Spring Boot 插件配置、常用任务对照、多模块组织与可执行 jar 打包差异,并给出选型建议。文中 Maven 示例已在本机 3.9.12 实测,Gradle 示例未实跑,仅作对照参考。
GitHub Actions Java/JVM CI 实战:Maven/Gradle 构建与缓存策略、多 JDK 版本矩阵测试(8/11/17/21)、JaCoCo 代码覆盖率与 SonarCloud 集成、SpotBugs/PMD/Checkstyle 静态分析、Jib 免 Dockerfile 容器化构建、Maven 多模块 Monorepo CI、性能基准测试(JMH)自动化、发布到 Maven Central/JitPack、Kotlin/Scala 混合项目构建
本节讲 Maven 构建加速:先给出定位慢在哪里的步骤,再逐项拆解跳过无用阶段、按模块增量构建、并行构建、依赖预拉与离线、CI 缓存本地仓库、镜像源与增量编译等手段,重点说明 4.1 中 -DskipTests 不再跳过测试 AOT 处理这一语义变化及替代写法。
本节讲 Spring Boot 多模块工程的版本对齐:对比 spring-boot-starter-parent 与 spring-boot-dependencies BOM 的引入方式与取舍,说明 import scope 的生效规则、如何自建 BOM 统一内部组件版本、如何用 properties 或显式声明覆盖托管版本,并汇总 4.x 各依赖的大版本变化与 4.0 移除的依赖管理。
本节用图书借阅服务 book-loan 的五模块工程讲透 Maven 依赖冲突排查:从 NoSuchMethodError 等症状反查依赖树,读懂 dependency:tree 的 omitted 与 conflict 标记,掌握最短路径优先与先声明优先两条调解规则,并给出 exclusions、dependencyManagement 与 dependency:analyze 的用法。
讲清父 POM 的 parent 继承与 dependencyManagement 版本管理的分工,演示导入 spring-boot-dependencies BOM、子模块声明依赖、用 Enforcer 预防版本冲突,以及可复用库模块的打包与发布方式。
本节讲清如何用 start.spring.io 生成项目骨架:逐字段说明表单怎么填,强调 4.x 中 Spring Web 对应 spring-boot-starter-webmvc;给出等价的 curl 命令行方式,逐段解读生成的 pom.xml,并用表格对比 3.x 与 4.x 生成物在 parent 版本与 starter 名上的差异。
本节搭建 Spring Boot 开发环境:说明为何锁定 Java 21 LTS,给出 macOS、Linux、Windows 三种 shell 下安装 JDK 与配置 JAVA_HOME 的写法,附 java -version 与 mvn -v 实测输出;再配置 ~/.m2/settings.xml 国内镜像加速,并汇总版本不匹配、JAVA_HOME 未生效、拉包慢等常见故障的排查方法。