构建系统
强烈建议您选择一个支持依赖管理且可以从Maven Central仓库获取构件的构建系统。我们建议您选择Maven或Gradle。Spring Boot可以与其他构建系统(例如Ant)配合使用,但它们的支持度不是特别好。
依赖管理
Spring Boot 的每个版本都提供了一份受支持的精选依赖列表。实际上,您不需要在构建配置中为这些依赖提供版本,因为 Spring Boot 会为您管理。当您升级 Spring Boot 本身时,这些依赖也会以一致的方式进行升级。
| 如果需要,您仍然可以指定版本并覆盖 Spring Boot 的建议。 |
这份精选列表包含了您可以与 Spring Boot 一起使用的所有 Spring 模块以及一份经过精炼的第三方库列表。该列表以标准材料清单(`spring-boot-dependencies`)的形式提供,可与 Maven 和 Gradle 一起使用。
| Spring Boot 的每个版本都与 Spring Framework 的基础版本相关联。我们强烈建议您不要指定其版本。 |
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="4.0.0" />
<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` 模块,请参阅“操作指南”中的不使用 spring-boot-antlib 从 Ant 构建可执行归档部分。 |
启动器
启动器是一组方便的依赖项描述符,您可以将其包含在您的应用程序中。您无需在示例代码中寻找并复制粘贴大量依赖项描述符,即可获得所有您需要的 Spring 及相关技术的一站式服务。例如,如果您想开始使用 Spring 和 JPA 进行数据库访问,只需在项目中包含 `spring-boot-starter-data-jpa` 依赖项。
启动器包含您快速启动项目所需的大量依赖项,并且提供了一套一致的、受管理的传递性依赖项。
以下应用程序启动器由 Spring Boot 在 `org.springframework.boot` 组下提供
| 名称 | 描述 |
|---|---|
核心启动器,包括自动配置支持、日志和 YAML |
|
用于 Apache ActiveMQ 和 JMS 的启动器 |
|
用于测试 Apache ActiveMQ 和 JMS 的启动器 |
|
用于测试 Spring Boot 的 Actuator 的启动器,Actuator 提供了生产就绪功能以帮助您监控和管理应用程序 |
|
用于 Spring AMQP 和 Rabbit MQ 的启动器 |
|
用于测试 Spring AMQP 和 Rabbit MQ 的启动器 |
|
用于 Apache Artemis 和 JMS 的启动器 |
|
用于测试 Apache Artemis 和 JMS 的启动器 |
|
用于使用 AspectJ 进行面向方面编程的启动器 |
|
用于测试使用 AspectJ 进行面向方面编程的启动器 |
|
用于 Spring Batch 的启动器 |
|
用于将 Spring Batch 与 JDBC 结合使用的启动器 |
|
用于测试将 Spring Batch 与 JDBC 结合使用的启动器 |
|
用于测试 Spring Batch 的启动器 |
|
用于 Spring 缓存支持的启动器 |
|
用于测试 Spring 缓存支持的启动器 |
|
用于使用 Cassandra 分布式数据库的启动器 |
|
用于测试 Cassandra 分布式数据库的启动器 |
|
核心经典启动器,包括完整的自动配置支持、日志和 YAML |
|
用于使用 Cloud Foundry 的启动器 |
|
用于测试 Cloud Foundry 的启动器 |
|
用于使用 Couchbase 文档型数据库的启动器 |
|
用于测试 Couchbase 文档型数据库的启动器 |
|
用于使用 Cassandra 分布式数据库和 Spring Data Cassandra 的启动器 |
|
用于使用 Cassandra 分布式数据库和 Spring Data Cassandra Reactive 的启动器 |
|
用于测试 Cassandra 分布式数据库和 Spring Data Cassandra Reactive 的启动器 |
|
用于测试 Cassandra 分布式数据库和 Spring Data Cassandra 的启动器 |
|
用于使用 Couchbase 文档型数据库和 Spring Data Couchbase 的启动器 |
|
用于使用 Couchbase 文档型数据库和 Spring Data Couchbase Reactive 的启动器 |
|
用于测试 Couchbase 文档型数据库和 Spring Data Couchbase Reactive 的启动器 |
|
用于测试 Couchbase 文档型数据库和 Spring Data Couchbase 的启动器 |
|
用于使用 Elasticsearch 搜索和分析引擎以及 Spring Data Elasticsearch 的启动器 |
|
用于测试 Elasticsearch 搜索和分析引擎以及 Spring Data Elasticsearch 的启动器 |
|
用于使用 Spring Data JDBC 的启动器 |
|
用于测试 Spring Data JDBC 的启动器 |
|
用于将 Spring Data JPA 与 Hibernate 结合使用的启动器 |
|
用于测试 Spring Data JPA 与 Hibernate 的启动器 |
|
用于使用 Spring Data LDAP 的启动器 |
|
用于测试 Spring Data LDAP 的启动器 |
|
用于使用 MongoDB 文档型数据库和 Spring Data MongoDB 的启动器 |
|
用于使用 MongoDB 文档型数据库和 Spring Data MongoDB Reactive 的启动器 |
|
用于使用 MongoDB 文档型数据库和 Spring Data MongoDB Reactive 的启动器 |
|
用于测试 MongoDB 文档型数据库和 Spring Data MongoDB 的启动器 |
|
用于使用 Neo4j 图形数据库和 Spring Data Neo4j 的启动器 |
|
用于测试 Neo4j 图形数据库和 Spring Data Neo4j 的启动器 |
|
用于使用 Spring Data R2DBC 的启动器 |
|
用于测试 Spring Data R2DBC 的启动器 |
|
用于使用 Redis 键值数据存储与 Spring Data Redis 和 Lettuce 客户端的启动器 |
|
用于使用 Redis 键值数据存储与 Spring Data Redis 响应式和 Lettuce 客户端的启动器 |
|
用于测试 Redis 键值数据存储与 Spring Data Redis 响应式和 Lettuce 客户端的启动器 |
|
用于测试 Redis 键值数据存储与 Spring Data Redis 和 Lettuce 客户端的启动器 |
|
用于使用 Spring Data REST 和 Spring MVC 通过 REST 公开 Spring Data 仓库的启动器 |
|
用于测试使用 Spring Data REST 和 Spring MVC 通过 REST 公开 Spring Data 仓库的启动器 |
|
用于使用 Elasticsearch 搜索和分析引擎的启动器 |
|
用于测试 Elasticsearch 搜索和分析引擎的启动器 |
|
用于使用 Flyway 数据库迁移的启动器 |
|
用于测试 Flyway 数据库迁移的启动器 |
|
用于使用 FreeMarker 的启动器 |
|
用于测试 FreeMarker 的启动器 |
|
使用 Spring GraphQL 的启动器 |
|
用于测试 Spring GraphQL 的启动器 |
|
用于使用 Groovy 模板的启动器 |
|
用于测试 Groovy 模板的启动器 |
|
用于使用 GSON 的启动器 |
|
用于测试 GSON 的启动器 |
|
用于使用 Spring HATEOS 构建基于超媒体的 RESTful Spring MVC Web 应用程序的启动器 |
|
用于测试使用 Spring HATEOS 构建基于超媒体的 RESTful Spring MVC Web 应用程序的启动器 |
|
用于使用 Hazelcast 的启动器 |
|
用于测试 Hazelcast 的启动器 |
|
用于使用 Spring Integration 的启动器 |
|
用于测试 Spring Integration 的启动器 |
|
用于使用 Jackson 的启动器 |
|
用于测试 Jackson 的启动器 |
|
用于使用 JDBC 和 HikariCP 连接池的启动器 |
|
用于测试 JDBC 和 HikariCP 连接池的启动器 |
|
用于使用 JAX-RS 和 Jersey 的启动器 |
|
用于测试 JAX-RS 和 Jersey 的启动器 |
|
用于使用 Jetty 作为嵌入式 servlet 容器的启动器 |
|
用于使用 JMS 的启动器 |
|
用于测试 JMS 的启动器 |
|
用于使用 jOOQ 通过 JDBC 访问 SQL 数据库的启动器 |
|
用于测试使用 jOOQ 通过 JDBC 访问 SQL 数据库的启动器 |
|
用于读取和写入 JSON 的启动器 |
|
用于使用 JSON-B 的启动器 |
|
用于测试 JSON-B 的启动器 |
|
用于使用 Apache Kafka 的启动器 |
|
用于测试 Apache Kafka 的启动器 |
|
用于使用 Kotlin Serialization 的启动器 |
|
用于测试 Kotlin Serialization 的启动器 |
|
用于使用 LDAP 的启动器 |
|
用于测试 LDAP 的启动器 |
|
用于使用 Liquibase 数据库迁移的启动器 |
|
用于测试 Liquibase 数据库迁移的启动器 |
|
用于使用 Java Mail 和 Spring Framework 电子邮件发送支持的启动器 |
|
用于测试 Java Mail 和 Spring Framework 电子邮件发送支持的启动器 |
|
用于使用 Micrometer Metrics 的启动器 |
|
用于测试 Micrometer Metrics 的启动器 |
|
用于使用 MongoDB 文档型数据库的启动器 |
|
用于测试 MongoDB 文档型数据库的启动器 |
|
用于使用 Mustache 的启动器 |
|
用于测试 Mustache 的启动器 |
|
用于使用 Neo4j 图形数据库的启动器 |
|
用于测试 Neo4j 图形数据库的启动器 |
|
用于使用 Spring 授权服务器功能的启动器(已弃用,建议使用`spring-boot-starter-security-oauth2-authorization-server`) |
|
用于使用 Spring Security 的 OAuth2/OpenID Connect 客户端功能的启动器(已弃用,建议使用`spring-boot-starter-security-oauth2-client`) |
|
用于使用 Spring Security 的 OAuth2 资源服务器功能的启动器(已弃用,建议使用`spring-boot-starter-security-oauth2-resource-server`) |
|
用于使用 OpenTelemetry 的启动器 |
|
用于测试 OpenTelemetry 的启动器 |
|
用于使用 Spring for Apache Pulsar 的启动器 |
|
用于测试 Spring for Apache Pulsar 的启动器 |
|
用于使用 Quartz 调度器的启动器 |
|
用于测试 Quartz 调度器的启动器 |
|
用于使用 R2DBC 的启动器 |
|
用于测试 R2DBC 的启动器 |
|
用于 Reactor Netty 的启动器 |
|
使用 Spring 阻塞式 HTTP 客户端(RestClient、RestTemplate 和 HTTP 服务客户端)的启动器 |
|
用于测试 Spring 阻塞式 HTTP 客户端(RestClient、RestTemplate 和 HTTP 服务客户端)的启动器 |
|
用于使用 RSocket 的启动器 |
|
用于测试 RSocket 的启动器 |
|
用于使用 Spring Security 的启动器 |
|
用于使用 Spring 授权服务器功能的启动器 |
|
`spring-boot-starter-security-oauth2-authorization-server-test` |
用于测试 Spring 授权服务器功能的启动器 |
用于使用 Spring Security 的 OAuth2/OpenID Connect 客户端功能的启动器 |
|
用于测试 Spring Security 的 OAuth2/OpenID Connect 客户端功能的启动器 |
|
用于使用 Spring Security 的 OAuth2 资源服务器功能的启动器 |
|
用于测试 Spring Security 的 OAuth2 资源服务器功能的启动器 |
|
用于将 Spring Security 与 SAML2 结合使用的启动器 |
|
用于测试 Spring Security 与 SAML2 的启动器 |
|
用于测试 Spring Security 的启动器 |
|
用于将 Spring Session 与 Sendgrid 结合使用的启动器 |
|
用于测试 Spring Session 与 Sendgrid 的启动器 |
|
用于将 Spring Session 与 Spring Data Redis 结合使用的启动器 |
|
用于测试 Spring Session 与 Spring Data Redis 的启动器 |
|
用于将 Spring Session 与 JDBC 结合使用的启动器 |
|
用于测试 Spring Session 与 JDBC 的启动器 |
|
用于测试 Spring Boot 应用程序的启动器,包含 JUnit Jupiter、Hamcrest 和 Mockito 等库 |
|
用于测试 Spring Boot 应用程序的经典启动器,包含 JUnit Jupiter、Hamcrest 和 Mockito 等库 |
|
用于使用 Thymeleaf 的启动器 |
|
用于测试 Thymeleaf 的启动器 |
|
用于使用 Tomcat 作为嵌入式 servlet 容器的启动器 |
|
用于使用 Java Bean Validation 和 Hibernate Validator 的启动器 |
|
用于测试 Java Bean Validation 和 Hibernate Validator 的启动器 |
|
用于使用 Spring MVC 构建 Web 应用程序(包括 RESTful 应用程序)的启动器。使用 Tomcat 作为默认嵌入式容器(已弃用,建议使用`spring-boot-starter-webmvc`) |
|
用于使用 Spring Web Services 的启动器(已弃用,建议使用`spring-boot-starter-webservices`) |
|
使用 Spring 响应式 HTTP 客户端(WebClient 和 HTTP 服务客户端)的启动器 |
|
用于测试 Spring 响应式 HTTP 客户端(WebClient 和 HTTP 服务客户端)的启动器 |
|
用于使用 WebFlux 和 Reactor Netty 的启动器 |
|
用于测试 WebFlux 和 Reactor Netty 的启动器 |
|
用于使用 Spring MVC 和 Tomcat 的启动器 |
|
用于测试 Spring MVC 和 Tomcat 的启动器 |
|
用于使用 Spring Web Services 的启动器 |
|
用于测试 Spring Web Services 的启动器 |
|
用于使用 Spring MVC WebSocket 支持的启动器 |
|
用于测试 Spring MVC WebSocket 支持的启动器 |
|
用于使用 Zipkin 的启动器 |
|
用于测试 Zipkin 的启动器 |
除了应用程序启动器之外,还可以使用以下启动器来添加生产就绪功能
| 名称 | 描述 |
|---|---|
用于 Spring Boot 的 Actuator 的启动器,它提供了生产就绪功能以帮助您监控和管理应用程序 |
最后,Spring Boot 还包括以下启动器,如果您想排除或替换特定技术方面,可以使用它们
| 名称 | 描述 |
|---|---|
用于 Jetty 运行时的启动器 |
|
用于使用 Log4j2 的启动器 |
|
用于使用 Logback 进行日志记录的启动器 |
|
用于默认日志记录的启动器 |
|
用于 Tomcat 运行时的启动器 |
要了解如何替换技术方面,请参阅关于替换 Web 服务器和日志系统的操作指南文档。
| 有关社区贡献的其他启动器的列表,请参阅 GitHub 上 `spring-boot-starters` 模块中的 README 文件。 |