Spring Boot - 已有 parent pom 时如何使用 parent pom

216
是否有特定的推荐方法将spring-boot父POM包含到已经具有所需父POM的项目中?
对于需要扩展自组织父级的项目(这是非常常见的,甚至是许多/大多数发布到Maven中央仓库的项目所依赖的原始仓库),您会推荐什么呢?大部分构建工作都与创建可执行的JAR文件相关(例如运行嵌入式Tomcat/Jetty)。有方法可以组织结构使您可以在不扩展父类的情况下获取所有依赖项(类似于组合VS继承)。但是,您无法以这种方式获得构建工具。
因此,是首选将所有spring-boot父POM包含到所需的父级POM中,还是只在项目POM文件中具有POM依赖项。
其他选项呢?
TIA,
斯科特
3个回答

199
你可以像使用“bom”一样使用spring-boot-starter-parent(参见Spring和Jersey等其他支持此功能的项目),并仅在依赖管理部分包含它,范围为import。这样,您就可以获得使用它的许多好处(例如依赖关系管理)而不替换实际父级中的设置。
它的另外两个主要作用是:
1. 定义了大量属性,用于快速设置要覆盖的依赖项版本。 2. 配置了一些插件的默认配置(主要是Spring Boot Maven插件)。因此,如果使用自己的父级,则需要手动执行这些操作。
示例提供在Spring Boot documentation中:
<dependencyManagement>
    <dependencies>
        <dependency>
            <!-- Import dependency management from Spring Boot -->
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.1.3.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

1
我猜这会导入插件 - shade等? - chrislovecnm
4
不。阅读链接:“您仍然可以保留依赖管理的好处(但不包括插件管理)”。 - Dave Syer
1
@DaveSyer 请澄清以下问题:1:当我有自定义的 project-parent 时,我可以将 spring-boot-starter-parent 添加到这个 project-parent 中吗?在这种情况下,我是否还需要 spring-boot-dependencies?2:普通的 spring-boot 项目我使用 spring-boot:run 运行。如何使用不同的父 POM 运行项目? - jsosnowski
1
不,必须是一个父POM才能继承<properties/> - Dave Syer
3
我知道这是一个旧的帖子,但它对我有很大帮助,谢谢。我最终在源头https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Importing_Dependencies读到了关于这个机制的内容。它解释得非常清楚。 - bazeusz
显示剩余7条评论

55

2022年5月29日更新版本为1.5.9.RELEASE。

我在这里提供了完整的代码和可运行示例https://github.com/surasint/surasint-examples/tree/master/spring-boot-jdbi/9_spring-boot-no-parent(请查看README.txt以了解如何尝试)。

您需要此内容作为基础。

   <dependencyManagement>
        <dependencies>
            <dependency>
                <!-- Import dependency management from Spring Boot -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${springframework.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

但仅此还不够,你还需要明确定义 spring-boot-maven-plugin 的目标(如果你使用 Spring Boot 作为 parent,则无需显式定义此内容)。

    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>${springframework.boot.version}</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>

否则你将无法构建可执行的jar或war文件。

如果你正在使用JSP,那么你需要有以下内容:

<properties>    
  <failOnMissingWebXml>false</failOnMissingWebXml>
</properties>
否则,您将收到此错误消息:
    [ERROR] Failed to execute goal org.apache.maven.plugins:maven-war-plugin:2.2:war (default-war) on project spring-boot-09: Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executi
ng in update mode) -> [Help 1]

不行,如果你在使用Maven Profile和Resource Filter与Spring Boot一起使用,并且使用"@ "而不是"${}"(例如这个例子 https://www.surasint.com/spring-boot-maven-resource-filter/),那么你需要在中明确添加这个。

    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>

并且这是在

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>2.7</version>
            <configuration>
                <delimiters>
                    <delimiter>@</delimiter>
                </delimiters>
                <useDefaultDelimiters>false</useDefaultDelimiters>
            </configuration>
        </plugin>

请查看链接中的示例 https://www.surasint.com/spring-boot-with-no-parent-example/


@Arvind 警告,我的示例是1.5.9。你应该使用1.5.11(昨天发布的版本),因为这个版本修复了一个严重的安全问题。 - Surasin Tancharoen
正如在您的博客中所提到的,我尝试添加maven-resources-plugin,但仍然出现“目标中没有主清单属性”的错误。我尝试运行spring-boot:run,但还是不起作用:( - sagar27
@sagar27 你使用的是1.5.X还是2.x版本?如果是2.x版本,可能需要更多的东西。 - Surasin Tancharoen
该链接无法访问。 - Nick Legend
@NickLegend 是的,我知道,谷歌没有提前警告就删除了我的整个虚拟机,甚至没有一封邮件……所以,不要使用gcloud。 - Surasin Tancharoen

3
根据Surasin Tancharoen的回答,您可能还需要定义maven surefire插件。
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>${maven-surefire-plugin.version}</version>
        </plugin>

并可能包含fail-fast插件

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-failsafe-plugin</artifactId>
        <version>${maven-failsafe-plugin.version}</version>
        <executions>
            <execution>
                <goals>
                    <goal>integration-test</goal>
                    <goal>verify</goal>
                </goals>
            </execution>
        </executions>
    </plugin>

包含maven-surefire-plugin对我来说是救命稻草。如果没有它,Spring Boot将无法为集成测试加载应用程序上下文。 - abbas

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接