構建系統
強烈建議您選擇一個支援依賴管理且可以從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 檔案。 |