構建系統

強烈建議您選擇一個支援依賴管理且可以從Maven Central倉庫獲取構件的構建系統。我們建議您選擇Maven或Gradle。Spring Boot可以與其他構建系統(例如Ant)配合使用,但它們的支援度不是特別好。

依賴管理

Spring Boot 的每個版本都提供了一份受支援的精選依賴列表。實際上,您不需要在構建配置中為這些依賴提供版本,因為 Spring Boot 會為您管理。當您升級 Spring Boot 本身時,這些依賴也會以一致的方式進行升級。

如果需要,您仍然可以指定版本並覆蓋 Spring Boot 的建議。

這份精選列表包含了您可以與 Spring Boot 一起使用的所有 Spring 模組以及一份經過精煉的第三方庫列表。該列表以標準材料清單(`spring-boot-dependencies`)的形式提供,可與 MavenGradle 一起使用。

Spring Boot 的每個版本都與 Spring Framework 的基礎版本相關聯。我們強烈建議您不要指定其版本。

Maven

要了解如何將 Spring Boot 與 Maven 結合使用,請參閱 Spring Boot Maven 外掛的文件

Gradle

要了解如何將 Spring Boot 與 Gradle 結合使用,請參閱 Spring Boot Gradle 外掛的文件

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-starter-*`,其中 `*` 是特定型別的應用程式。這種命名結構旨在幫助您查詢啟動器。許多 IDE 中的 Maven 整合允許您按名稱搜尋依賴項。例如,安裝了相應的 Eclipse 或 Spring Tools 外掛後,您可以在 POM 編輯器中按下 `ctrl-space` 並輸入“spring-boot-starter”以獲取完整列表。

建立自己的啟動器部分所述,第三方啟動器不應以`spring-boot`開頭,因為這保留給官方Spring Boot構件。相反,第三方啟動器通常以專案名稱開頭。例如,一個名為`thirdpartyproject`的第三方啟動器專案通常會命名為`thirdpartyproject-spring-boot-starter`。

以下應用程式啟動器由 Spring Boot 在 `org.springframework.boot` 組下提供

表 1. Spring Boot 應用程式啟動器
名稱 描述

`spring-boot-starter`

核心啟動器,包括自動配置支援、日誌和 YAML

`spring-boot-starter-activemq`

用於 Apache ActiveMQ 和 JMS 的啟動器

`spring-boot-starter-activemq-test`

用於測試 Apache ActiveMQ 和 JMS 的啟動器

`spring-boot-starter-actuator-test`

用於測試 Spring Boot 的 Actuator 的啟動器,Actuator 提供了生產就緒功能以幫助您監控和管理應用程式

`spring-boot-starter-amqp`

用於 Spring AMQP 和 Rabbit MQ 的啟動器

`spring-boot-starter-amqp-test`

用於測試 Spring AMQP 和 Rabbit MQ 的啟動器

`spring-boot-starter-artemis`

用於 Apache Artemis 和 JMS 的啟動器

`spring-boot-starter-artemis-test`

用於測試 Apache Artemis 和 JMS 的啟動器

`spring-boot-starter-aspectj`

用於使用 AspectJ 進行面向方面程式設計的啟動器

`spring-boot-starter-aspectj-test`

用於測試使用 AspectJ 進行面向方面程式設計的啟動器

`spring-boot-starter-batch`

用於 Spring Batch 的啟動器

`spring-boot-starter-batch-jdbc`

用於將 Spring Batch 與 JDBC 結合使用的啟動器

`spring-boot-starter-batch-jdbc-test`

用於測試將 Spring Batch 與 JDBC 結合使用的啟動器

`spring-boot-starter-batch-test`

用於測試 Spring Batch 的啟動器

`spring-boot-starter-cache`

用於 Spring 快取支援的啟動器

`spring-boot-starter-cache-test`

用於測試 Spring 快取支援的啟動器

`spring-boot-starter-cassandra`

用於使用 Cassandra 分散式資料庫的啟動器

`spring-boot-starter-cassandra-test`

用於測試 Cassandra 分散式資料庫的啟動器

`spring-boot-starter-classic`

核心經典啟動器,包括完整的自動配置支援、日誌和 YAML

`spring-boot-starter-cloudfoundry`

用於使用 Cloud Foundry 的啟動器

`spring-boot-starter-cloudfoundry-test`

用於測試 Cloud Foundry 的啟動器

`spring-boot-starter-couchbase`

用於使用 Couchbase 文件型資料庫的啟動器

`spring-boot-starter-couchbase-test`

用於測試 Couchbase 文件型資料庫的啟動器

`spring-boot-starter-data-cassandra`

用於使用 Cassandra 分散式資料庫和 Spring Data Cassandra 的啟動器

`spring-boot-starter-data-cassandra-reactive`

用於使用 Cassandra 分散式資料庫和 Spring Data Cassandra Reactive 的啟動器

`spring-boot-starter-data-cassandra-reactive-test`

用於測試 Cassandra 分散式資料庫和 Spring Data Cassandra Reactive 的啟動器

`spring-boot-starter-data-cassandra-test`

用於測試 Cassandra 分散式資料庫和 Spring Data Cassandra 的啟動器

`spring-boot-starter-data-couchbase`

用於使用 Couchbase 文件型資料庫和 Spring Data Couchbase 的啟動器

`spring-boot-starter-data-couchbase-reactive`

用於使用 Couchbase 文件型資料庫和 Spring Data Couchbase Reactive 的啟動器

`spring-boot-starter-data-couchbase-reactive-test`

用於測試 Couchbase 文件型資料庫和 Spring Data Couchbase Reactive 的啟動器

`spring-boot-starter-data-couchbase-test`

用於測試 Couchbase 文件型資料庫和 Spring Data Couchbase 的啟動器

`spring-boot-starter-data-elasticsearch`

用於使用 Elasticsearch 搜尋和分析引擎以及 Spring Data Elasticsearch 的啟動器

`spring-boot-starter-data-elasticsearch-test`

用於測試 Elasticsearch 搜尋和分析引擎以及 Spring Data Elasticsearch 的啟動器

`spring-boot-starter-data-jdbc`

用於使用 Spring Data JDBC 的啟動器

`spring-boot-starter-data-jdbc-test`

用於測試 Spring Data JDBC 的啟動器

`spring-boot-starter-data-jpa`

用於將 Spring Data JPA 與 Hibernate 結合使用的啟動器

`spring-boot-starter-data-jpa-test`

用於測試 Spring Data JPA 與 Hibernate 的啟動器

`spring-boot-starter-data-ldap`

用於使用 Spring Data LDAP 的啟動器

`spring-boot-starter-data-ldap-test`

用於測試 Spring Data LDAP 的啟動器

`spring-boot-starter-data-mongodb`

用於使用 MongoDB 文件型資料庫和 Spring Data MongoDB 的啟動器

`spring-boot-starter-data-mongodb-reactive`

用於使用 MongoDB 文件型資料庫和 Spring Data MongoDB Reactive 的啟動器

`spring-boot-starter-data-mongodb-reactive-test`

用於使用 MongoDB 文件型資料庫和 Spring Data MongoDB Reactive 的啟動器

`spring-boot-starter-data-mongodb-test`

用於測試 MongoDB 文件型資料庫和 Spring Data MongoDB 的啟動器

`spring-boot-starter-data-neo4j`

用於使用 Neo4j 圖形資料庫和 Spring Data Neo4j 的啟動器

`spring-boot-starter-data-neo4j-test`

用於測試 Neo4j 圖形資料庫和 Spring Data Neo4j 的啟動器

`spring-boot-starter-data-r2dbc`

用於使用 Spring Data R2DBC 的啟動器

`spring-boot-starter-data-r2dbc-test`

用於測試 Spring Data R2DBC 的啟動器

`spring-boot-starter-data-redis`

用於使用 Redis 鍵值資料儲存與 Spring Data Redis 和 Lettuce 客戶端的啟動器

`spring-boot-starter-data-redis-reactive`

用於使用 Redis 鍵值資料儲存與 Spring Data Redis 響應式和 Lettuce 客戶端的啟動器

`spring-boot-starter-data-redis-reactive-test`

用於測試 Redis 鍵值資料儲存與 Spring Data Redis 響應式和 Lettuce 客戶端的啟動器

`spring-boot-starter-data-redis-test`

用於測試 Redis 鍵值資料儲存與 Spring Data Redis 和 Lettuce 客戶端的啟動器

`spring-boot-starter-data-rest`

用於使用 Spring Data REST 和 Spring MVC 透過 REST 公開 Spring Data 倉庫的啟動器

`spring-boot-starter-data-rest-test`

用於測試使用 Spring Data REST 和 Spring MVC 透過 REST 公開 Spring Data 倉庫的啟動器

`spring-boot-starter-elasticsearch`

用於使用 Elasticsearch 搜尋和分析引擎的啟動器

`spring-boot-starter-elasticsearch-test`

用於測試 Elasticsearch 搜尋和分析引擎的啟動器

`spring-boot-starter-flyway`

用於使用 Flyway 資料庫遷移的啟動器

`spring-boot-starter-flyway-test`

用於測試 Flyway 資料庫遷移的啟動器

`spring-boot-starter-freemarker`

用於使用 FreeMarker 的啟動器

`spring-boot-starter-freemarker-test`

用於測試 FreeMarker 的啟動器

`spring-boot-starter-graphql`

使用 Spring GraphQL 的啟動器

`spring-boot-starter-graphql-test`

用於測試 Spring GraphQL 的啟動器

`spring-boot-starter-groovy-templates`

用於使用 Groovy 模板的啟動器

`spring-boot-starter-groovy-templates-test`

用於測試 Groovy 模板的啟動器

`spring-boot-starter-gson`

用於使用 GSON 的啟動器

`spring-boot-starter-gson-test`

用於測試 GSON 的啟動器

`spring-boot-starter-hateoas`

用於使用 Spring HATEOS 構建基於超媒體的 RESTful Spring MVC Web 應用程式的啟動器

`spring-boot-starter-hateoas-test`

用於測試使用 Spring HATEOS 構建基於超媒體的 RESTful Spring MVC Web 應用程式的啟動器

`spring-boot-starter-hazelcast`

用於使用 Hazelcast 的啟動器

`spring-boot-starter-hazelcast-test`

用於測試 Hazelcast 的啟動器

`spring-boot-starter-integration`

用於使用 Spring Integration 的啟動器

`spring-boot-starter-integration-test`

用於測試 Spring Integration 的啟動器

`spring-boot-starter-jackson`

用於使用 Jackson 的啟動器

`spring-boot-starter-jackson-test`

用於測試 Jackson 的啟動器

`spring-boot-starter-jdbc`

用於使用 JDBC 和 HikariCP 連線池的啟動器

`spring-boot-starter-jdbc-test`

用於測試 JDBC 和 HikariCP 連線池的啟動器

`spring-boot-starter-jersey`

用於使用 JAX-RS 和 Jersey 的啟動器

`spring-boot-starter-jersey-test`

用於測試 JAX-RS 和 Jersey 的啟動器

`spring-boot-starter-jetty`

用於使用 Jetty 作為嵌入式 servlet 容器的啟動器

`spring-boot-starter-jms`

用於使用 JMS 的啟動器

`spring-boot-starter-jms-test`

用於測試 JMS 的啟動器

`spring-boot-starter-jooq`

用於使用 jOOQ 透過 JDBC 訪問 SQL 資料庫的啟動器

`spring-boot-starter-jooq-test`

用於測試使用 jOOQ 透過 JDBC 訪問 SQL 資料庫的啟動器

`spring-boot-starter-json`

用於讀取和寫入 JSON 的啟動器

`spring-boot-starter-jsonb`

用於使用 JSON-B 的啟動器

`spring-boot-starter-jsonb-test`

用於測試 JSON-B 的啟動器

`spring-boot-starter-kafka`

用於使用 Apache Kafka 的啟動器

`spring-boot-starter-kafka-test`

用於測試 Apache Kafka 的啟動器

`spring-boot-starter-kotlin-serialization`

用於使用 Kotlin Serialization 的啟動器

`spring-boot-starter-kotlin-serialization-test`

用於測試 Kotlin Serialization 的啟動器

`spring-boot-starter-ldap`

用於使用 LDAP 的啟動器

`spring-boot-starter-ldap-test`

用於測試 LDAP 的啟動器

`spring-boot-starter-liquibase`

用於使用 Liquibase 資料庫遷移的啟動器

`spring-boot-starter-liquibase-test`

用於測試 Liquibase 資料庫遷移的啟動器

`spring-boot-starter-mail`

用於使用 Java Mail 和 Spring Framework 電子郵件傳送支援的啟動器

`spring-boot-starter-mail-test`

用於測試 Java Mail 和 Spring Framework 電子郵件傳送支援的啟動器

`spring-boot-starter-micrometer-metrics`

用於使用 Micrometer Metrics 的啟動器

`spring-boot-starter-micrometer-metrics-test`

用於測試 Micrometer Metrics 的啟動器

`spring-boot-starter-mongodb`

用於使用 MongoDB 文件型資料庫的啟動器

`spring-boot-starter-mongodb-test`

用於測試 MongoDB 文件型資料庫的啟動器

`spring-boot-starter-mustache`

用於使用 Mustache 的啟動器

`spring-boot-starter-mustache-test`

用於測試 Mustache 的啟動器

`spring-boot-starter-neo4j`

用於使用 Neo4j 圖形資料庫的啟動器

`spring-boot-starter-neo4j-test`

用於測試 Neo4j 圖形資料庫的啟動器

`spring-boot-starter-oauth2-authorization-server`

用於使用 Spring 授權伺服器功能的啟動器(已棄用,建議使用`spring-boot-starter-security-oauth2-authorization-server`

`spring-boot-starter-oauth2-client`

用於使用 Spring Security 的 OAuth2/OpenID Connect 客戶端功能的啟動器(已棄用,建議使用`spring-boot-starter-security-oauth2-client`

`spring-boot-starter-oauth2-resource-server`

用於使用 Spring Security 的 OAuth2 資源伺服器功能的啟動器(已棄用,建議使用`spring-boot-starter-security-oauth2-resource-server`

`spring-boot-starter-opentelemetry`

用於使用 OpenTelemetry 的啟動器

`spring-boot-starter-opentelemetry-test`

用於測試 OpenTelemetry 的啟動器

`spring-boot-starter-pulsar`

用於使用 Spring for Apache Pulsar 的啟動器

`spring-boot-starter-pulsar-test`

用於測試 Spring for Apache Pulsar 的啟動器

`spring-boot-starter-quartz`

用於使用 Quartz 排程器的啟動器

`spring-boot-starter-quartz-test`

用於測試 Quartz 排程器的啟動器

`spring-boot-starter-r2dbc`

用於使用 R2DBC 的啟動器

`spring-boot-starter-r2dbc-test`

用於測試 R2DBC 的啟動器

`spring-boot-starter-reactor-netty`

用於 Reactor Netty 的啟動器

`spring-boot-starter-restclient`

使用 Spring 阻塞式 HTTP 客戶端(RestClient、RestTemplate 和 HTTP 服務客戶端)的啟動器

`spring-boot-starter-restclient-test`

用於測試 Spring 阻塞式 HTTP 客戶端(RestClient、RestTemplate 和 HTTP 服務客戶端)的啟動器

`spring-boot-starter-rsocket`

用於使用 RSocket 的啟動器

`spring-boot-starter-rsocket-test`

用於測試 RSocket 的啟動器

`spring-boot-starter-security`

用於使用 Spring Security 的啟動器

`spring-boot-starter-security-oauth2-authorization-server`

用於使用 Spring 授權伺服器功能的啟動器

`spring-boot-starter-security-oauth2-authorization-server-test`

用於測試 Spring 授權伺服器功能的啟動器

`spring-boot-starter-security-oauth2-client`

用於使用 Spring Security 的 OAuth2/OpenID Connect 客戶端功能的啟動器

`spring-boot-starter-security-oauth2-client-test`

用於測試 Spring Security 的 OAuth2/OpenID Connect 客戶端功能的啟動器

`spring-boot-starter-security-oauth2-resource-server`

用於使用 Spring Security 的 OAuth2 資源伺服器功能的啟動器

`spring-boot-starter-security-oauth2-resource-server-test`

用於測試 Spring Security 的 OAuth2 資源伺服器功能的啟動器

`spring-boot-starter-security-saml2`

用於將 Spring Security 與 SAML2 結合使用的啟動器

`spring-boot-starter-security-saml2-test`

用於測試 Spring Security 與 SAML2 的啟動器

`spring-boot-starter-security-test`

用於測試 Spring Security 的啟動器

`spring-boot-starter-sendgrid`

用於將 Spring Session 與 Sendgrid 結合使用的啟動器

`spring-boot-starter-sendgrid-test`

用於測試 Spring Session 與 Sendgrid 的啟動器

`spring-boot-starter-session-data-redis`

用於將 Spring Session 與 Spring Data Redis 結合使用的啟動器

`spring-boot-starter-session-data-redis-test`

用於測試 Spring Session 與 Spring Data Redis 的啟動器

`spring-boot-starter-session-jdbc`

用於將 Spring Session 與 JDBC 結合使用的啟動器

`spring-boot-starter-session-jdbc-test`

用於測試 Spring Session 與 JDBC 的啟動器

`spring-boot-starter-test`

用於測試 Spring Boot 應用程式的啟動器,包含 JUnit Jupiter、Hamcrest 和 Mockito 等庫

`spring-boot-starter-test-classic`

用於測試 Spring Boot 應用程式的經典啟動器,包含 JUnit Jupiter、Hamcrest 和 Mockito 等庫

`spring-boot-starter-thymeleaf`

用於使用 Thymeleaf 的啟動器

`spring-boot-starter-thymeleaf-test`

用於測試 Thymeleaf 的啟動器

`spring-boot-starter-tomcat`

用於使用 Tomcat 作為嵌入式 servlet 容器的啟動器

`spring-boot-starter-validation`

用於使用 Java Bean Validation 和 Hibernate Validator 的啟動器

`spring-boot-starter-validation-test`

用於測試 Java Bean Validation 和 Hibernate Validator 的啟動器

`spring-boot-starter-web`

用於使用 Spring MVC 構建 Web 應用程式(包括 RESTful 應用程式)的啟動器。使用 Tomcat 作為預設嵌入式容器(已棄用,建議使用`spring-boot-starter-webmvc`

`spring-boot-starter-web-services`

用於使用 Spring Web Services 的啟動器(已棄用,建議使用`spring-boot-starter-webservices`

`spring-boot-starter-webclient`

使用 Spring 響應式 HTTP 客戶端(WebClient 和 HTTP 服務客戶端)的啟動器

`spring-boot-starter-webclient-test`

用於測試 Spring 響應式 HTTP 客戶端(WebClient 和 HTTP 服務客戶端)的啟動器

`spring-boot-starter-webflux`

用於使用 WebFlux 和 Reactor Netty 的啟動器

`spring-boot-starter-webflux-test`

用於測試 WebFlux 和 Reactor Netty 的啟動器

`spring-boot-starter-webmvc`

用於使用 Spring MVC 和 Tomcat 的啟動器

`spring-boot-starter-webmvc-test`

用於測試 Spring MVC 和 Tomcat 的啟動器

`spring-boot-starter-webservices`

用於使用 Spring Web Services 的啟動器

`spring-boot-starter-webservices-test`

用於測試 Spring Web Services 的啟動器

`spring-boot-starter-websocket`

用於使用 Spring MVC WebSocket 支援的啟動器

`spring-boot-starter-websocket-test`

用於測試 Spring MVC WebSocket 支援的啟動器

`spring-boot-starter-zipkin`

用於使用 Zipkin 的啟動器

`spring-boot-starter-zipkin-test`

用於測試 Zipkin 的啟動器

除了應用程式啟動器之外,還可以使用以下啟動器來新增生產就緒功能

表 2. Spring Boot 生產啟動器
名稱 描述

`spring-boot-starter-actuator`

用於 Spring Boot 的 Actuator 的啟動器,它提供了生產就緒功能以幫助您監控和管理應用程式

最後,Spring Boot 還包括以下啟動器,如果您想排除或替換特定技術方面,可以使用它們

表 3. Spring Boot 技術啟動器
名稱 描述

`spring-boot-starter-jetty-runtime`

用於 Jetty 執行時的啟動器

`spring-boot-starter-log4j2`

用於使用 Log4j2 的啟動器

`spring-boot-starter-logback`

用於使用 Logback 進行日誌記錄的啟動器

`spring-boot-starter-logging`

用於預設日誌記錄的啟動器

`spring-boot-starter-tomcat-runtime`

用於 Tomcat 執行時的啟動器

要了解如何替換技術方面,請參閱關於替換 Web 伺服器日誌系統的操作指南文件。

有關社群貢獻的其他啟動器的列表,請參閱 GitHub 上 `spring-boot-starters` 模組中的 README 檔案
© . This site is unofficial and not affiliated with VMware.