Spring Boot 2.6.11 中文文档速览：迈向3.x的阶梯

需积分: 3 8 浏览量更新于2024-06-16 收藏 18.82MB PDF 举报

"Spring Boot 2.6.11 中文版是官方文档的一个版本，适合学习和准备过渡到Spring Boot 3.x的开发者参考。文档由多位核心贡献者编著，包括Phillip Webb, Dave Syer, Josh Long等。它涵盖了Spring Boot的基本概念、升级指南、Web开发、数据处理、消息传递、IO操作、镜像容器化以及高级主题。文档还提供了入门教程，包括系统需求、安装方法、开发第一个应用的步骤，并指导如何从旧版本升级到Spring Boot 2.6.11。" Spring Boot是一款流行的Java框架，旨在简化Spring应用程序的初始设置和常规配置。在Spring Boot 2.6.11版本中，用户可以学习如何利用它的自动配置功能、创建独立的可执行JARs以及集成各种Spring生态系统的服务，如Spring Web、Spring Data等。文档首先强调了获取帮助的渠道，这对于遇到问题时快速解决问题至关重要。接着，文档介绍了从早期版本升级的步骤，这对于保持项目更新至最新稳定版本很有帮助。文档的“入门”部分详细解释了Spring Boot的基础知识，包括系统要求，例如Servlet容器的兼容性。安装指南覆盖了多种工具，如Maven、Gradle、Spring Boot CLI，以及在不同操作系统上的安装选项。快速入门部分则演示了一个简单的RESTful服务的创建过程，涉及POM配置、添加依赖、使用@RestController和@RequestMapping注解来定义控制器，以及启用自动配置和主类。对于开发者来说，了解如何从1.x版本升级到2.6.11或更高版本是至关重要的，文档提供了明确的指引。此外，还提到了升级Spring Boot CLI的方法，这对于依赖命令行工具进行开发的用户尤其有用。 Spring Boot 2.6.11中文版文档是学习和深入理解Spring Boot生态系统的宝贵资源，无论是初学者还是经验丰富的开发者，都能从中受益。随着Spring Boot 3.x的到来，这份文档更是作为过渡的桥梁，帮助开发者适应新的变化。

作为 init.d 服务安装 (System V) . . . . . . . . . . . . . . . Ê433

作为 systemd 服务安装

. . . . . . . . . . . . . . . . . . . . Ê435

自定义启动脚本

. . . . . . . . . . . . . . . . . . . . . . . . Ê436

14.2.3. Microsoft Windows 服务

. . . . . . . . . . . . . . . . Ê441

14.3. 下一步

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê441

15. Spring Boot CLI

. . . . . . . . . . . . . . . . . . . . . . . . Ê442

15.1. 安装 CLI

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê442

15.2. 使用 CLI

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê442

15.2.1. 使用 CLI 运行应用程序

. . . . . . . . . . . . . . . . . . Ê443

推测 “grab” 依赖

. . . . . . . . . . . . . . . . . . . . . . . Ê444

推测 “grab” 坐标

. . . . . . . . . . . . . . . . . . . . . . . Ê445

默认导入语句

. . . . . . . . . . . . . . . . . . . . . . . . . Ê445

自动创建 Main 方法

. . . . . . . . . . . . . . . . . . . . . . Ê446

自定义依赖管理

. . . . . . . . . . . . . . . . . . . . . . . . Ê446

15.2.2. 具有多个源文件的应用程序

. . . . . . . . . . . . . . . . . Ê446

15.2.3. 打包你的应用程序

. . . . . . . . . . . . . . . . . . . . Ê447

15.2.4. 初始化新项目

. . . . . . . . . . . . . . . . . . . . . . Ê447

15.2.5. 使用嵌入式 Shell

. . . . . . . . . . . . . . . . . . . . Ê448

15.2.6. 添加 CLI 扩展

. . . . . . . . . . . . . . . . . . . . . Ê449

15.3. 使用 Groovy Beans DSL 开发应用程序

. . . . . . . . . . . . . . Ê449

15.4. 使用 settings.xml 配置 CLI

. . . . . . . . . . . . . . . . . Ê450

15.5. 下一步

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê451

16. 构建工具插件

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê452

16.1. Spring Boot Maven 插件

. . . . . . . . . . . . . . . . . . . Ê452

16.2. Spring Boot Gradle 插件

. . . . . . . . . . . . . . . . . . Ê452

16.3. Spring Boot AntLib 模块

. . . . . . . . . . . . . . . . . . Ê452

16.3.1. Spring Boot Ant 任务

. . . . . . . . . . . . . . . . . Ê453

使用 “exejar” Task

. . . . . . . . . . . . . . . . . . . . . Ê453

例子

. . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê454

16.3.2. 使用 “findmainclass” Task

. . . . . . . . . . . . . . . Ê454

例子

. . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê455

16.4. 支持其他构建系统

. . . . . . . . . . . . . . . . . . . . . . . Ê455

16.4.1. 重新打包 Archives

. . . . . . . . . . . . . . . . . . . Ê455

16.4.2. 嵌套库

. . . . . . . . . . . . . . . . . . . . . . . . . Ê455

16.4.3. 查找 Main Class

. . . . . . . . . . . . . . . . . . . . Ê456

16.4.4. 重新打包示例实现

. . . . . . . . . . . . . . . . . . . . Ê456

16.5. 接下来阅读什么

. . . . . . . . . . . . . . . . . . . . . . . . Ê457

17. “How-to” 指南

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê458

17.1. Spring Boot Application

. . . . . . . . . . . . . . . . . . Ê458

17.1.1. 创建自己的 FailureAnalyzer

. . . . . . . . . . . . . . . Ê458

17.1.2. 自动配置故障排除

. . . . . . . . . . . . . . . . . . . . Ê459

17.1.3. 启动之前自定义环境或 ApplicationContext

. . . . . . . . . Ê459

17.1.4. 建立 ApplicationContext 层次结构 (添加父上下文或根上下文)

. Ê462

17.1.5. 创建一个非 Web 应用程序

. . . . . . . . . . . . . . . . . Ê462

17.2. 属性和配置

. . . . . . . . . . . . . . . . . . . . . . . . . Ê462

17.2.1. 在构建时自动扩展属性

. . . . . . . . . . . . . . . . . . . Ê462

使用 Maven 自动扩展属性

. . . . . . . . . . . . . . . . . . . . Ê463

使用 Gradle 自动扩展属性

. . . . . . . . . . . . . . . . . . . Ê464

17.2.2. 外部化配置 SpringApplication

. . . . . . . . . . . . . . Ê465

17.2.3. 更改应用程序外部属性的位置

. . . . . . . . . . . . . . . . Ê466

17.2.4. 使用 ‘Short’ 命令行参数

. . . . . . . . . . . . . . . . . Ê467

17.2.5. 对外部属性使用 YAML

. . . . . . . . . . . . . . . . . . . Ê467

17.2.6. 设置 Active Spring Profiles

. . . . . . . . . . . . . . Ê468

17.2.7. 设置默认的 Profile Name

. . . . . . . . . . . . . . . . Ê469

17.2.8. 根据环境更改配置

. . . . . . . . . . . . . . . . . . . . Ê469

17.2.9. 发现外部属性的内置选项

. . . . . . . . . . . . . . . . . . Ê470

17.3. 嵌入式 Web 服务器

. . . . . . . . . . . . . . . . . . . . . . Ê471

17.3.1. 使用其他 Web 服务器

. . . . . . . . . . . . . . . . . . . Ê471

17.3.2. 禁用 Web 服务器

. . . . . . . . . . . . . . . . . . . . Ê474

17.3.3. 更改 HTTP 端口

. . . . . . . . . . . . . . . . . . . . . Ê474

17.3.4. 使用随机未分配的 HTTP 端口

. . . . . . . . . . . . . . . . Ê475

17.3.5. 在运行时发现 HTTP 端口

. . . . . . . . . . . . . . . . . Ê475

17.3.6. 启用 HTTP 响应压缩

. . . . . . . . . . . . . . . . . . . Ê475

17.3.7. 配置 SSL

. . . . . . . . . . . . . . . . . . . . . . . Ê476

17.3.8. 配置 HTTP/2

. . . . . . . . . . . . . . . . . . . . . . Ê477

Tomcat HTTP/2

. . . . . . . . . . . . . . . . . . . . . . . Ê477

Jetty HTTP/2

. . . . . . . . . . . . . . . . . . . . . . . . Ê478

Reactor Netty HTTP/2

. . . . . . . . . . . . . . . . . . . . Ê478

Undertow HTTP/2

. . . . . . . . . . . . . . . . . . . . . . Ê478

17.3.9. 配置 Web 服务器

. . . . . . . . . . . . . . . . . . . . Ê478

17.3.10. 将 Servlet, Filter, Listener 添加到应用程序

. . . . . . Ê480

使用 Spring Bean 添加 Servlet, Filter, 或 Listener

. . . . . . Ê480

使用类路径扫描添加 Servlets, Filters, 和 Listeners

. . . . . . . Ê481

17.3.11. 配置访问日志

. . . . . . . . . . . . . . . . . . . . . . Ê481

17.3.12. 在前端代理服务器后面运行

. . . . . . . . . . . . . . . . . Ê483

自定义 Tomcat 的代理配置

. . . . . . . . . . . . . . . . . . . Ê483

17.3.13. 使用 Tomcat 启用多个连接器

. . . . . . . . . . . . . . . Ê484

17.3.14. 使用 Tomcat 的 LegacyCookieProcessor

. . . . . . . . . Ê485

17.3.15. 启用 Tomcat 的 MBean 注册表

. . . . . . . . . . . . . . Ê486

17.3.16. 使用 Undertow 启用多个监听器

. . . . . . . . . . . . . . Ê487

17.3.17. 使用 @ServerEndpoint 创建 WebSocket 端点

. . . . . . . . Ê487

17.4. Spring MVC

. . . . . . . . . . . . . . . . . . . . . . . . Ê488

17.4.1. 编写 JSON REST 服务

. . . . . . . . . . . . . . . . . . Ê488

17.4.2. 编写 XML REST 服务

. . . . . . . . . . . . . . . . . . . Ê489

17.4.3. 自定义 Jackson ObjectMapper

. . . . . . . . . . . . . . Ê490

17.4.4. 自定义 @ResponseBody 渲染

. . . . . . . . . . . . . . . Ê492

17.4.5. 处理分段文件上传

. . . . . . . . . . . . . . . . . . . . Ê493

17.4.6. 关闭 Spring MVC DispatcherServlet

. . . . . . . . . . . Ê493

17.4.7. 关闭默认的 MVC 配置

. . . . . . . . . . . . . . . . . . . Ê494

17.4.8. 自定义 ViewResolvers

. . . . . . . . . . . . . . . . . . Ê494

17.5. Jersey

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê495

17.5.1. 使用 Spring Security 保护 Jersey 端点

. . . . . . . . . . Ê496

17.5.2. 与另一个 Web 框架一起使用 Jersey

. . . . . . . . . . . . . Ê496

17.6. HTTP Clients

. . . . . . . . . . . . . . . . . . . . . . . Ê497

17.6.1. 配置 RestTemplate 使用代理

. . . . . . . . . . . . . . . Ê497

17.6.2. 配置基于 Reactor Netty 的 WebClient 使用的 TcpClient

. . Ê497

17.7. Logging

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê498

17.7.1. 配置 Logback Logging

. . . . . . . . . . . . . . . . . Ê499

配置仅文件输出的 Logback

. . . . . . . . . . . . . . . . . . . Ê501

17.7.2. 配置 Log4j 日志

. . . . . . . . . . . . . . . . . . . . Ê501

使用 YAML 或 JSON 配置 Log4j 2

. . . . . . . . . . . . . . . . Ê503

使用复合配置来配置 Log4j 2

. . . . . . . . . . . . . . . . . . Ê503

17.8. 数据访问

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê503

17.8.1. 配置自定义数据源

. . . . . . . . . . . . . . . . . . . . Ê503

17.8.2. 配置两个数据源

. . . . . . . . . . . . . . . . . . . . . Ê508

17.8.3. 使用 Spring Data Repositories

. . . . . . . . . . . . . Ê512

17.8.4. 将 @Entity 定义与 Spring 配置分开

. . . . . . . . . . . . Ê512

17.8.5. 配置 JPA 属性

. . . . . . . . . . . . . . . . . . . . . Ê513

17.8.6. 配置 Hibernate 命名策略

. . . . . . . . . . . . . . . . . Ê514

17.8.7. 配置 Hibernate 二级缓存

. . . . . . . . . . . . . . . . . Ê516

17.8.8. 在 Hibernate 组件中使用依赖注入

. . . . . . . . . . . . . Ê517

17.8.9. 使用自定义 EntityManagerFactory . . . . . . . . . . . . Ê517

17.8.10. 使用多个 EntityManagerFactories

. . . . . . . . . . . . Ê517

17.8.11. 使用传统的 persistence.xml 文件

. . . . . . . . . . . . Ê521

17.8.12. 使用 Spring Data JPA 和 Mongo 存储库

. . . . . . . . . . Ê521

17.8.13. 定制 Spring Data 的 Web 支持

. . . . . . . . . . . . . Ê521

17.8.14. 将 Spring Data Repositories 暴露为 REST 端点

. . . . . . Ê522

17.8.15. 配置 JPA 使用的组件

. . . . . . . . . . . . . . . . . . Ê522

17.8.16. 使用两个数据源配置 jOOQ

. . . . . . . . . . . . . . . . . Ê523

17.9. 初始化 Database

. . . . . . . . . . . . . . . . . . . . . . Ê523

17.9.1. 使用 JPA 初始化数据库

. . . . . . . . . . . . . . . . . . Ê523

17.9.2. 使用 Hibernate 初始化数据库

. . . . . . . . . . . . . . . Ê524

17.9.3. 使用 SQL 脚本初始化数据库

. . . . . . . . . . . . . . . . Ê524

17.9.4. 初始化一个 Spring Batch 数据库

. . . . . . . . . . . . . Ê525

17.9.5. 使用高级数据库迁移工具

. . . . . . . . . . . . . . . . . . Ê525

在启动时执行 Flyway 数据库迁移

. . . . . . . . . . . . . . . . . Ê526

在启动时执行 Liquibase 数据库迁移

. . . . . . . . . . . . . . . Ê527

17.9.6. 依赖于一个初始化的数据库

. . . . . . . . . . . . . . . . . Ê528

检测数据库初始化程序

. . . . . . . . . . . . . . . . . . . . . . Ê528

检测依赖于数据库初始化的 Bean

. . . . . . . . . . . . . . . . . Ê529

17.10. 消息

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê529

17.10.1. 禁用事务 JMS 会话

. . . . . . . . . . . . . . . . . . . Ê529

17.11. Batch Applications

. . . . . . . . . . . . . . . . . . . . Ê530

17.11.1. 指定批处理数据源

. . . . . . . . . . . . . . . . . . . . Ê530

17.11.2. 在启动时执行 Spring Batch 作业

. . . . . . . . . . . . . Ê531

17.11.3. 在命令行上运行

. . . . . . . . . . . . . . . . . . . . . Ê531

17.11.4. 存储 Job Repository

. . . . . . . . . . . . . . . . . Ê531

17.12. Actuator

. . . . . . . . . . . . . . . . . . . . . . . . . Ê532

17.12.1. Actuator 端点更改 HTTP 端口或地址

. . . . . . . . . . . . Ê532

17.12.2. 自定义 ‘whitelabel’ 错误页面

. . . . . . . . . . . . . . Ê532

17.12.3. Sanitize Sensitive Values

. . . . . . . . . . . . . . Ê533

自定义 Sanitization

. . . . . . . . . . . . . . . . . . . . . Ê533

17.12.4. 映射健康状态

. . . . . . . . . . . . . . . . . . . . . . Ê534

17.13. 安全

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê535

17.13.1. 关闭 Spring Boot 安全性配置

. . . . . . . . . . . . . . Ê536

17.13.2. 更改 UserDetailsService 并添加用户帐户

. . . . . . . . . Ê536

17.13.3. 在代理服务器后运行时启用 HTTPS

. . . . . . . . . . . . . . Ê536

17.14. Hot Swapping(热交换)

. . . . . . . . . . . . . . . . . . . Ê537

17.14.1. 重新加载静态内容

. . . . . . . . . . . . . . . . . . . . Ê537

17.14.2. 重新加载模板,而无需重新启动容器

. . . . . . . . . . . . . . Ê538

Thymeleaf 模板

. . . . . . . . . . . . . . . . . . . . . . . Ê538

FreeMarker 模板

. . . . . . . . . . . . . . . . . . . . . . . Ê538

Groovy 模板

. . . . . . . . . . . . . . . . . . . . . . . . . Ê538

17.14.3. 快速重启应用程序

. . . . . . . . . . . . . . . . . . . . Ê538

17.14.4. 重新加载 Java 类而无需重新启动容器

. . . . . . . . . . . . Ê538

17.15. 测试

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê538

17.15.1. 使用 Spring Security 进行测试

. . . . . . . . . . . . . Ê539

17.15.2. 在集成测试中使用 Testcontainers

. . . . . . . . . . . . Ê539

17.15.3. Structure @Configuration classes for inclusion in

slice tests . . . . . . . . . . . . . . . . . . . . . . . . . . Ê541

17.16. 构建

. . . . . . . . . . . . . . . . . . . . . . . . . . . Ê543

17.16.1. 生成构建信息

. . . . . . . . . . . . . . . . . . . . . . Ê544

17.16.2. 生成 Git 信息

. . . . . . . . . . . . . . . . . . . . . Ê544

17.16.3. 自定义依赖版本

. . . . . . . . . . . . . . . . . . . . . Ê545

17.16.4. 使用 Maven 创建可执行 JAR

. . . . . . . . . . . . . . . Ê546

17.16.5. 使用 Spring Boot 应用程序作为依赖

. . . . . . . . . . . . Ê546

17.16.6. 运行可执行 jar 时提取特定的库

. . . . . . . . . . . . . . Ê547

17.16.7. 创建带有排除项的不可执行的 JAR

. . . . . . . . . . . . . . Ê548

17.16.8. 远程调试以 Maven 开头的 Spring Boot 应用程序

. . . . . . . Ê549

17.16.9. 在不使用 spring-boot-antlib 的情况下从 Ant

构建可执行归档文件

. . . . . . . . . . . . . . . . . . . . . . . . Ê549

17.17. 传统部署

. . . . . . . . . . . . . . . . . . . . . . . . . . Ê550

17.17.1. 创建可部署的 War 文件

. . . . . . . . . . . . . . . . . Ê551

17.17.2. 将现有应用程序转换为 Spring Boot

. . . . . . . . . . . . Ê552

17.17.3. 将 WAR 部署到 WebLogic

. . . . . . . . . . . . . . . . Ê556

Appendices

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê558

Appendix A: 公共应用程序属性

. . . . . . . . . . . . . . . . . . . . Ê558

.A.1. Core Properties

. . . . . . . . . . . . . . . . . . . . . Ê558

.A.2. Cache Properties

. . . . . . . . . . . . . . . . . . . . Ê574

.A.3. Mail Properties

. . . . . . . . . . . . . . . . . . . . . Ê576

.A.4. JSON Properties

. . . . . . . . . . . . . . . . . . . . . Ê577

.A.5. Data Properties

. . . . . . . . . . . . . . . . . . . . . Ê581

.A.6. Transaction Properties

. . . . . . . . . . . . . . . . . Ê618

.A.7. Data Migration Properties

. . . . . . . . . . . . . . . . Ê624

.A.8. Integration Properties

. . . . . . . . . . . . . . . . . Ê638

.A.9. Web Properties

. . . . . . . . . . . . . . . . . . . . . Ê676

剩余923页未读，继续阅读

阿提说说

粉丝: 1w+
资源: 21

Spring Boot 2.6.11 中文文档速览：迈向3.x的阶梯

Spring Boot 最新中文文档

Spring Boot 中文文档.pdf

Spring Boot 中文文档 参考手册 中文版.pdf

spring boot 2.6.11+springcloud Swagger3构建微服务项目源码

基于Spring Boot 2.6.11构建微服务架构项目源码分析

spring-boot 2.6.11 可以用哪个版本mybatis

spring boot、spring cloud、spring boot Alibaba以及配套组件版本关系

升级Spring Boot项目到2.6.11版本时，需要关注哪些核心变化并如何进行兼容性调整？

升级Spring Boot项目到2.6.11版本，开发者应如何规划并执行这一过程，特别是涉及到依赖和配置的变更？

SkyBlog:一个简单的Spring Boot + Vue 前后端分离的博客系统 https

最新资源

Spring Boot 中文文档参考手册中文版.pdf