SpringBoot 官方文档中文版 - 2. 构建系统

前言

这是 SpringBoot 官方文档中文翻译版系列第二篇文章。

上一篇是：SpringBoot 官方文档中文版 - 1. 入门指南

根据官网的顺序，从构建系统，到将应用程序打包用于生产，是官网中 user.html 这一章的内容，因为篇幅较长，故拆分成若干章节。

使用 SpringBoot 进行开发

本节将更详细地介绍如何使用 Spring Boot。它涵盖了构建系统、自动配置以及如何运行应用程序等主题。我们还将介绍一些 Spring Boot 的最佳实践。尽管 Spring Boot 没有什么特别之处(它只是您可以使用的另一个库)，但是有一些建议，如果遵循这些建议，将使您的开发过程稍微容易一些。

如果您正在开始使用 Spring Boot，那么在深入本节之前，您可能应该阅读入门指南。

构建系统

强烈建议您选择支持依赖项管理并能够使用发布到 “Maven Central” 存储库的构件的构建系统。我们建议您选择 Maven 或 Gradle。可以让 Spring Boot 与其他构建系统(例如Ant)一起工作，但它们并没有得到很好的支持。

1. 依赖管理

Spring Boot 的每个版本都提供了它所支持的依赖项列表。实际上，您不需要在构建配置中为这些依赖项提供一个版本，因为 Spring Boot 会为您管理它。当您升级 Spring Boot 本身时，这些依赖项也会以一致的方式升级。

提示：如果需要的话，您仍然可以指定一个版本并覆盖 Spring Boot 的建议。

这个列表包含了所有可以与 Spring Boot 一起使用的 Spring 模块，以及一个改进的第三方库列表。该列表作为标准的材料清单(spring-boot-dependencies)可用，可以与 Maven 和 Gradle 一起使用。

警告：Spring Boot 的每个版本都与 Spring 框架的一个基本版本相关联。我们强烈建议您不要指定它的版本。

2. Maven

要了解如何使用 Spring Boot 与 Maven，请参阅 Spring Boot 的 Maven 插件的文档:

• 文档 (HTML 和 PDF)

• API

3. Gradle

要了解如何在 Gradle 中使用 Spring Boot，请参考 Spring Boot 的 Gradle 插件的文档:

• 文档 (HTML and PDF)

• API

4. Ant

可以使用 Apache Ant+Ivy 构建 Spring Boot 项目。spring-boot-antlib“AntLib” 模块还可以帮助 Ant 创建可执行 jar。

要声明依赖关系，一个典型的 ivy.xml 文件看起来像下面的例子:

<ivy-module version="2.0">
    <info organisation="org.springframework.boot" module="spring-boot-sample-ant" />
    <configurations>
        <conf name="compile" description="everything needed to compile this module" />
        <conf name="runtime" extends="compile" description="everything needed to run this module" />
    </configurations>
    <dependencies>
        <dependency org="org.springframework.boot" name="spring-boot-starter"
            rev="${spring-boot.version}" conf="compile" />
    </dependencies>
</ivy-module>

一个典型的 build.xml 示例如下:

<project
    xmlns:ivy="antlib:org.apache.ivy.ant"
    xmlns:spring-boot="antlib:org.springframework.boot.ant"
    name="myapp" default="build">

    <property name="spring-boot.version" value="2.5.3" />

    <target name="resolve" description="--> retrieve dependencies with ivy">
        <ivy:retrieve pattern="lib/[conf]/[artifact]-[type]-[revision].[ext]" />
    </target>

    <target name="classpaths" depends="resolve">
        <path id="compile.classpath">
            <fileset dir="lib/compile" includes="*.jar" />
        </path>
    </target>

    <target name="init" depends="classpaths">
        <mkdir dir="build/classes" />
    </target>

    <target name="compile" depends="init" description="compile">
        <javac srcdir="src/main/java" destdir="build/classes" classpathref="compile.classpath" />
    </target>

    <target name="build" depends="compile">
        <spring-boot:exejar destfile="build/myapp.jar" classes="build/classes">
            <spring-boot:lib>
                <fileset dir="lib/runtime" />
            </spring-boot:lib>
        </spring-boot:exejar>
    </target>
</project>

提示：如果您不想使用 spring-boot-antlib 模块，请参阅 howto.html " How-to "。

5. Starters

starters 是一组方便的依赖项描述符，您可以将其包含在应用程序中。您可以获得所需的所有 Spring 和相关技术的一站式服务，而无需遍寻示例代码和复制粘贴依赖描述符。例如，如果您想开始使用 Spring 和 JPA 进行数据库访问，请在项目中包含Spring -boot-start -data- JPA 依赖项。

starters 包含许多依赖项，您需要这些依赖项才能使项目快速启动和运行，并具有一组一致的、受支持的托管传递依赖项。

所有官方的 starters 都遵循类似的命名模式：Spring-boot-starter -，其中是一种特殊类型的应用程序。这个命名结构旨在帮助您找到初学者。许多 ide 中的 Maven 集成允许您按名称搜索依赖项。例如，安装了适当的 Eclipse 或 Spring Tools 插件后，您可以在 POM 编辑器中按 ctrl-space 并输入“Spring -boot-starter”来获得完整的列表。

正如在“创建您自己的 starter”一节中解释的那样，第三方 starters 的名字不应该以 Spring - Boot 开头，因为它是为官方 Spring Boot 工件保留的。相反，第三方 starters 通常以项目的名称开始。例如，名为 thirdpartyproject 的第三方 starter 项目通常被命名为 thirdpartyproject-spring-boot-starter。

下面的 starters 是由 Spring Boot 在 org.springframework.boot 组下提供的:

表1： Spring Boot application starters

名称	描述
spring-boot-starter	核心 starter，包括自动配置支持、日志记录和 YAML
spring-boot-starter-activemq	使用 Apache ActiveMQ 的 JMS 消息传递 starter
spring-boot-starter-amqp	使用 Spring AMQP 和 Rabbit MQ 的 starter
spring-boot-starter-aop	使用 Spring AO P和 AspectJ 进行面向方面编程的 starter
spring-boot-starter-artemis	使用 Apache Artemis 的进行 JMS 消息传递的 starter
spring-boot-starter-batch	使用 Spring Batch 的 starter
spring-boot-starter-cache	使用 Spring 框架的缓存支持的 starter
spring-boot-starter-data-cassandra	使用 Cassandra 分布式数据库和 Spring Data Cassandra 的 starter
spring-boot-starter-data-cassandra-reactive	使用 Cassandra 分布式数据库和 Spring Data Cassandra Reactive 的 starter
spring-boot-starter-data-couchbase	使用 Couchbase 面向文档的数据库和 Spring Data Couchbase 的 starter
spring-boot-starter-data-couchbase-reactive	使用 Couchbase 面向文档的数据库和 Spring Data Couchbase Reactive 的 starter
spring-boot-starter-data-elasticsearch	使用 Elasticsearch 搜索和分析引擎和 Spring Data Elasticsearch 的 starter
spring-boot-starter-data-jdbc	Starter for using Spring Data JDBC
spring-boot-starter-data-jpa	Starter for using Spring Data JPA with Hibernate
spring-boot-starter-data-ldap	Starter for using Spring Data LDAP
spring-boot-starter-data-mongodb	Starter for using MongoDB document-oriented database and Spring Data MongoDB
spring-boot-starter-data-mongodb-reactive	Starter for using MongoDB document-oriented database and Spring Data MongoDB Reactive
spring-boot-starter-data-neo4j	Starter for using Neo4j graph database and Spring Data Neo4j
spring-boot-starter-data-r2dbc	Starter for using Spring Data R2DBC
spring-boot-starter-data-redis	使用 Redis key-value 数据存储与 Spring data Redis 和 Lettuce 客户端
spring-boot-starter-data-redis-reactive	使用 Redis key-value 数据存储与 Spring data Redis Reactive 和 Lettuce 客户端
spring-boot-starter-data-rest	Starter for exposing Spring Data repositories over REST using Spring Data REST
spring-boot-starter-groovy-templates	Starter for building MVC web applications using Groovy Templates views
spring-boot-starter-hateoas	Starter for building hypermedia-based RESTful web application with Spring MVC and Spring HATEOAS
spring-boot-starter-integration	Starter for using Spring Integration
spring-boot-starter-jdbc	使用 JDBC 与 HikariCP 连接池
spring-boot-starter-jersey	使用 JAX-RS 和 Jersey 构建 RESTful web 应用程序的 starter。spring-boot-starter-web 的替代方案。
spring-boot-starter-jooq	使用 jOOQ 访问 SQL 数据库，可以替代 spring-boot-starter-data-jpa 或 spring-boot-starter-jdbc
spring-boot-starter-json	Starter for reading and writing json
spring-boot-starter-jta-atomikos	Starter for JTA transactions using Atomikos
spring-boot-starter-mail	使用 Java 邮件和 Spring 框架的电子邮件发送支持
spring-boot-starter-mustache	Starter for building web applications using Mustache views
spring-boot-starter-oauth2-client	使用 Spring Security 的 OAuth2/OpenID 连接客户端
spring-boot-starter-oauth2-resource-server	Starter for using Spring Security’s OAuth2 resource server features
spring-boot-starter-quartz	Starter for using the Quartz scheduler
spring-boot-starter-rsocket	Starter for building RSocket clients and servers
spring-boot-starter-security	Starter for using Spring Security
spring-boot-starter-test	Starter for testing Spring Boot applications with libraries including JUnit Jupiter, Hamcrest and Mockito
spring-boot-starter-thymeleaf	Starter for building MVC web applications using Thymeleaf views
spring-boot-starter-validation	使用 Hibernate 验证器对 Java Bean 进行验证
spring-boot-starter-web	使用 Spring MVC 构建 web，包括 RESTful 应用程序，使用 Tomcat 作为默认的嵌入式容器。
spring-boot-starter-web-services	Starter for using Spring Web Services
spring-boot-starter-webflux	使用 Spring 框架的响应式 Web 支持构建 WebFlux 应用程序
spring-boot-starter-websocket	使用 Spring 框架的 WebSocket 支持来构建 WebSocket 应用程序。

表2： Spring Boot production starters

名称	描述
spring-boot-starter-actuator	使用 Spring Boot’s Actuator，它提供了生产准备功能，以帮助您监视和管理您的应用程序。

最后，Spring Boot 还包括以下 starters，如果您想排除或交换特定的技术方面，可以使用它们:

表3: SpringBoot 技术 starters

名称	描述
spring-boot-starter-jetty	初学者使用 Jetty 作为嵌入式 servlet 容器。可以替代 spring-boot-starter-tomcat
spring-boot-starter-log4j2	使用 Log4j2 进行日志记录的 starter，spring-boot-starter-logging 的替代方法
spring-boot-starter-logging	使用 Logback 进行日志记录的 starter，默认的日志 starter
spring-boot-starter-reactor-netty	使用 Reactor Netty 作为嵌入式响应式 HTTP 服务器的 starter。
spring-boot-starter-tomcat	使用 Tomcat 作为嵌入式 servlet 容器的 starter。默认的 servlet 容器启动器由 spring-boot-starter-web 使用。
spring-boot-starter-undertow	使用 Undertow 作为嵌入式 servlet 容器的 starter。可以替代 spring-boot-starter-tomcat

有关社区贡献的其他 starters 列表，请参阅 GitHub 上 spring-boot-starter 模块中的 README 文件。

每天学习一点点，每天进步一点点。