spring-boot-skill

Spring Boot 技能

开发 Spring Boot 应用时，请遵循以下实践。仅在处理相关领域时阅读链接的参考资料。

Maven pom.xml 配置

阅读 references/spring-boot-maven-config.md，了解 Maven pom.xml 配置，以及用于提升代码质量和改进测试的支持插件与配置。

包结构

阅读 references/code-organization.md，了解领域驱动、基于模块的包布局和命名约定。

Spring Data JPA

使用 references/spring-data-jpa.md 实现仓库层和实体层。

服务层

使用 references/spring-service-layer.md 在服务层实现业务逻辑。

Spring MVC REST API

使用 Spring MVC 实现 REST API，参阅 references/spring-webmvc-rest-api.md。

Spring Modulith

使用 Spring Modulith 构建模块化单体，参阅 references/spring-modulith.md。

Thymeleaf

如果使用 Thymeleaf 作为视图模板，请参阅 references/thymeleaf.md

测试

在互补的层级编写测试——单元测试、Spring 切片测试，以及至少一个端到端／冒烟测试；这些层级并非二选一。大多数涉及框架的测试应放在快速的切片层级（@SpringBootTest(classes = …) 或切片注解）；完整上下文的 @SpringBootTest 应用于冒烟测试和请求级端到端测试。若想了解各层级为何互补，以及如何通过上下文缓存、整个测试套件共用一个容器来加快大型测试套件，请阅读 references/testing-strategy.md。

测试内容	层级	参考资料
业务／领域逻辑，不涉及框架	单元测试（无 Spring 上下文）	testing-unit-mocking.md
JPA / JDBC / JdbcClient / Spring Data JDBC / jOOQ 查询	持久化切片 + Testcontainers	testing-slices-persistence.md
控制器、JSON 序列化或 REST 客户端	Web 切片（@WebMvcTest/@JsonTest/@RestClientTest）	testing-slices-web.md
少量组件协同、外部 HTTP（WireMock），或启动／请求级冒烟测试	切片 @SpringBootTest(classes = …) 或冒烟测试	testing-integration.md
通过真实端口调用完整 REST API、完整的 BaseIT 测试套件（RestTestClient）	端到端测试	spring-boot-rest-api-testing.md
渲染视图的控制器（MockMvcTester）	Web 切片	spring-boot-webapp-testing-with-mockmvctester.md
配置容器（@ServiceConnection／动态属性）	—	testcontainers-wiring.md

所有持久化和集成测试都使用 Testcontainers 和真实数据库（绝不使用内存中的 H2）；关于 @ServiceConnection 与动态属性配置，请参阅 references/testcontainers-wiring.md。

编写 ArchUnit 测试

使用 ArchUnit 编写架构测试，请参阅 references/archunit.md

Spring Boot Docker Compose 支持

如需在本地开发中使用 Docker Compose 支持，请参阅 references/spring-boot-docker-compose.md。

Taskfile

使用 references/taskfile.md 更轻松地执行命令。