|
此版本仍在开发中,尚未视为稳定版。如需最新稳定版本,请使用 Spring Boot 4.0.4! |
使用插件
Maven 用户可以继承 spring-boot-starter-parent 项目以获得合理的默认配置。
该父项目提供以下功能:
-
Java 17 作为默认的编译器级别。
-
UTF-8 源文件编码。
-
使用
-parameters进行编译。 -
一个从
spring-boot-dependenciesPOM 继承而来的依赖管理部分,用于管理常用依赖项的版本。 此依赖管理机制允许您在自己的 POM 中使用这些依赖项时省略<version>标签。 -
一次带有
repackage执行 ID 的repackage目标 执行。 -
一个
native配置文件,用于配置构建以生成原生镜像(Native image)。 -
合理的资源过滤。
-
合理的插件配置(
Git Commit Id Plugin和 shade)。 -
对
application.properties和application.yml文件(包括特定于配置文件的文件,例如application-dev.properties和application-dev.yml)进行合理的资源过滤
由于 application.properties 和 application.yml 文件接受 Spring 风格的占位符(${…}),因此 Maven 过滤被更改为使用 @..@ 占位符。
(你可以通过设置一个名为 resource.delimiter 的 Maven 属性来覆盖该行为。) |
|
然后改为配置源选项和目标选项:
|
继承 Starter 父 POM
要将您的项目配置为继承自 spring-boot-starter-parent,请按如下方式设置 parent:
<!-- Inherit defaults from Spring Boot -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>4.1.0-SNAPSHOT</version>
</parent>
| 您只需在此依赖项中指定 Spring Boot 的版本号即可。 如果您导入了其他 starter,可以安全地省略版本号。 |
完成上述配置后,你还可以通过在自己的项目中覆盖某个属性来单独替换特定的依赖项。
例如,若要使用不同版本的 SLF4J 库和 Spring Data 发布版系列,你可以在 pom.xml 中添加以下内容:
<properties>
<slf4j.version>1.7.30</slf4j.version>
<spring-data-bom.version>2024.1.10</spring-data-bom.version>
</properties>
在 Spring Boot 参考文档中浏览依赖版本属性部分,以获取完整的依赖版本属性列表。
| 每个 Spring Boot 版本都是针对一组特定的第三方依赖进行设计和测试的。 覆盖版本可能会导致兼容性问题,应谨慎操作。 |
不使用父 POM 使用 Spring Boot
你可能有理由不继承 spring-boot-starter-parent POM。
你可能已有自己的公司标准父 POM 必须使用,或者你可能更倾向于显式声明所有的 Maven 配置。
如果你不想使用 spring-boot-starter-parent,仍然可以通过使用作用域为 import 的依赖项来保留依赖管理的好处(但不包括插件管理),如下所示:
<dependencyManagement>
<dependencies>
<dependency>
<!-- Import dependency management from Spring Boot -->
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>4.1.0-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
如上所述,前述示例配置不允许您通过使用属性来覆盖单个依赖项。
要实现相同的效果,您需要在项目 dependencyManagement 部分中、spring-boot-dependencies 条目之前添加相应条目。
例如,若要使用不同版本的 SLF4J 库和 Spring Data 发布系列,您可以在 pom.xml 中添加以下元素:
<dependencyManagement>
<dependencies>
<!-- Override SLF4J provided by Spring Boot -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.30</version>
</dependency>
<!-- Override Spring Data release train provided by Spring Boot -->
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-bom</artifactId>
<version>2024.1.10</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>4.1.0-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
在命令行上覆盖设置
该插件提供了一系列以 spring-boot 开头的用户属性,允许您从命令行自定义配置。
例如,您可以调整配置文件,以在运行应用程序时启用如下设置:
$ mvn spring-boot:run -Dspring-boot.run.profiles=dev,local
如果你既想设置一个默认值,又允许通过命令行覆盖它,就应该结合使用用户提供的项目属性和 MOJO 配置。
<project>
<properties>
<app.profiles>local,dev</app.profiles>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<profiles>${app.profiles}</profiles>
</configuration>
</plugin>
</plugins>
</build>
</project>
上述配置确保 local 和 dev 默认启用。
现在已暴露一个专用属性,也可以通过命令行进行覆盖:
$ mvn spring-boot:run -Dapp.profiles=test