Spring Boot入门指南

需积分: 42 90 浏览量更新于2024-07-16 收藏 11.02MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

"Spring Boot Reference Documentation 是一份由多位作者共同编写的权威指南，包括 Phillip Webb、Dave Syer、Josh Long 等 Spring 社区的重要贡献者。这份文档旨在为开发者提供全面的 Spring Boot 使用指南，帮助他们快速上手并深入理解 Spring Boot 的各种特性。" Spring Boot 是一个用于简化 Spring 应用程序初始搭建以及开发过程的框架。它通过自动配置、起步依赖（Starter POMs）和内嵌的Servlet容器（如Tomcat或Jetty）等特性，使得创建独立的、生产级别的基于Spring的应用变得极其简单。 1. 关于文档文档介绍了 Spring Boot 的设计理念，提供了获取帮助的途径，引导新手进行初步操作，并讲解了如何将应用推向生产环境。此外，还涵盖了高级主题，以满足不同层次开发者的需求。 2. 开始使用 - 引入 Spring Boot：解释 Spring Boot 如何简化了传统 Spring 应用的构建过程，以及其核心优势。 - 系统要求：列出了运行 Spring Boot 所需的硬件和软件条件，包括Servlet容器的兼容性，如Tomcat和Jetty。 - 安装 Spring Boot：提供了针对 Java 开发者的安装指南，涵盖了 Maven 和 Gradle 的集成，以及 Spring Boot CLI（命令行界面）的安装方法，包括手动安装、SDKMAN!、OSX Homebrew、MacPorts、Windows Scoop 等多种安装方式。同时，文档还指导如何从旧版本升级到新版本。 - 开发第一个 Spring Boot 应用：详细步骤指导如何创建项目的 POM 文件，添加依赖，以及编写基本的“Hello World”应用程序。 3. 功能学习文档的后续部分将详细介绍 Spring Boot 的各种功能，如自动配置、健康检查、外部配置、安全、数据访问、测试、监控和日志记录等。这些章节会深入解析如何利用这些功能来构建高效且易于维护的Spring应用程序。 4. 生产环境准备文档还将涵盖将应用程序部署到生产环境的相关策略，包括性能优化、安全设置、监控和日志管理等，确保应用程序在生产环境中稳定运行。 5. 高级主题针对有经验的开发者，这部分将探讨更复杂和特定的场景，如自定义启动行为、使用不同数据库、集成第三方服务等，帮助开发者充分利用 Spring Boot 的灵活性和扩展性。 "Spring Boot Reference Documentation" 是一份详尽的指南，无论你是初学者还是资深开发者，都能从中找到所需的信息，以有效地使用 Spring Boot 构建现代、高效的Java应用程序。

资源详情

资源推荐

9.9.12. Use Spring Data JPA and Mongo Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê327

9.9.13. Customize Spring Data’s Web Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê327

9.9.14. Expose Spring Data Repositories as REST Endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê328

9.9.15. Configure a Component that is Used by JPA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê328

9.9.16. Configure jOOQ with Two DataSources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê328

9.10. Database Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê329

9.10.1. Initialize a Database Using JPA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê329

9.10.2. Initialize a Database Using Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê329

9.10.3. Initialize a Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê329

9.10.4. Initialize a Spring Batch Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê330

9.10.5. Use a Higher-level Database Migration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê330

Execute Flyway Database Migrations on Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê330

Execute Liquibase Database Migrations on Startup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê331

9.11. Messaging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê332

9.11.1. Disable Transacted JMS Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê332

9.12. Batch Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê332

9.12.1. Execute Spring Batch Jobs on Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê333

9.13. Actuator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê333

9.13.1. Change the HTTP Port or Address of the Actuator Endpoints . . . . . . . . . . . . . . . . . . . . . . . Ê333

9.13.2. Customize the ‘whitelabel’ Error Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê334

9.13.3. Sanitize sensible values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê334

9.14. Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê334

9.14.1. Switch off the Spring Boot Security Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê334

9.14.2. Change the UserDetailsService and Add User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê334

9.14.3. Enable HTTPS When Running behind a Proxy Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê335

9.15. Hot Swapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê335

9.15.1. Reload Static Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê335

9.15.2. Reload Templates without Restarting the Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê336

Thymeleaf Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê336

FreeMarker Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê336

Groovy Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê336

9.15.3. Fast Application Restarts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê336

9.15.4. Reload Java Classes without Restarting the Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê336

9.16. Build . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê337

9.16.1. Generate Build Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê337

9.16.2. Generate Git Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê337

9.16.3. Customize Dependency Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê338

9.16.4. Create an Executable JAR with Maven . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê339

9.16.5. Use a Spring Boot Application as a Dependency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê339

9.16.6. Extract Specific Libraries When an Executable Jar Runs . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê340

9.16.7. Create a Non-executable JAR with Exclusions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê341

9.16.8. Remote Debug a Spring Boot Application Started with Maven. . . . . . . . . . . . . . . . . . . . . . Ê342

9.16.9. Build an Executable Archive from Ant without Using spring-boot-antlib . . . . . . . . . . . Ê342

9.17. Traditional Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê343

9.17.1. Create a Deployable War File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê343

9.17.2. Convert an Existing Application to Spring Boot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê345

9.17.3. Deploying a WAR to WebLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê348

9.17.4. Use Jedis Instead of Lettuce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê348

10. Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê350

Appendix A: Common Application properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê350

10.A.1. Core properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê350

10.A.2. Cache properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê355

10.A.3. Mail properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê356

10.A.4. JSON properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê357

10.A.5. Data properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê358

10.A.6. Transaction properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê372

10.A.7. Data migration properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê380

10.A.8. Integration properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê384

10.A.9. Web properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê396

10.A.10. Templating properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê401

10.A.11. Server properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê406

10.A.12. Security properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê413

10.A.13. RSocket properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê416

10.A.14. Actuator properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê416

10.A.15. Devtools properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê434

10.A.16. Testing properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê435

Appendix B: Configuration Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê435

10.B.1. Metadata Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê435

Group Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê437

Property Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê438

Hint Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê440

Repeated Metadata Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê441

10.B.2. Providing Manual Hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê441

Value Hint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê442

Value Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê442

10.B.3. Generating Your Own Metadata by Using the Annotation Processor . . . . . . . . . . . . . . . . Ê449

Nested Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê451

Adding Additional Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê452

Appendix C: Auto-configuration Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê452

10.C.1. spring-boot-autoconfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê452

10.C.2. spring-boot-actuator-autoconfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê456

Appendix D: Test Auto-configuration Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê459

10.D.1. Test Slices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê459

Appendix E: The Executable Jar Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê464

10.E.1. Nested JARs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê465

The Executable Jar File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê465

The Executable War File Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê465

10.E.2. Spring Boot’s “JarFile” Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê466

Compatibility with the Standard Java “JarFile”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê467

10.E.3. Launching Executable Jars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê467

Launcher Manifest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê467

10.E.4. PropertiesLauncher Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê468

10.E.5. Executable Jar Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê469

10.E.6. Alternative Single Jar Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê469

Appendix F: Dependency versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê470

10.F.1. Managed Dependency Coordinates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê470