Springboot的maven间接依赖

在项目中经常使用 maven 来管理项目，但是有时候对于 maven 的细节还是了解的不是很清楚，因此今天复习下。

maven项目

首先开始建立一个最简单的 maven 项目，其配置如下图：

可以看到最上面一行是 xml 的文件描述符，然后再是 project，在这里引入 xsd 文件。

XSD(XML Schemas Definition)XML Schema，描述了 xml 文档的结构，用于判断其是否符合 xml 的格式要求

然后下面就是 groupId，通常是公司的域名，artifactId 通常指的是项目名称。

Springboot项目

按照官方的指导，在项目中首先引用 spring-boot-starter-parent，修改后的 pom.xml 如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>maven-test</artifactId>
    <version>1.0-SNAPSHOT</version>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.2.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
    <finalName>maven-test</finalName>
</build>
</project>

当准备在启动类上加 @SpringBootApplication 注解的时候，此时 IDEA 会提示找不到这个注解。这是正常的，因为 parent 只是把这个项目的配置和依赖信息统一化了，使得 子pom 就不用关心版本问题，例如在项目中引入spring-boot-starter-web，当配置了 parent 之后，只需要在 子pom 中如下配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

那么它的配置信息就会自动的从 parent 中读取。例如刚刚的spring-boot-starter-web信息，它的版本信息如下：

tips:使用命令mvn -Dverbose dependency:tree就可以像这样打印 jar 的依赖

那么 springboot 又是怎样来自动识别版本号的呢，此时就就涉及到了spring-boot-dependencies

spring-boot-dependencies

spring-boot-dependencies 是 spring-boot-starter-parent 的一个 parent，可以在 spring-boot-starter-parent 的 pom 文件中看到。
打开 spring-boot-dependencies 文件，你会发现它里面几乎全部都是一些配置信息，而刚刚的spring-boot-dependencies 版本号就是来自于此。

到目前为止，可以基本理清 springboot 的依赖关系了。

打包

在工程中，随便写一个 controller，然后执行mvn package，此时会在 target 目录下出现一个 jar 包，然后运行 jar 包，正常启动OK。

替换parent

既然 spring-boot-starter-parent 是依赖于 spring-boot-dependencies的，那么可不可以直接将parent 设置为spring-boot-dependencies呢，修改 pom 文件如下:

然后执行mvn package，执行的时候是成功的，但是当你用 java -jar maven-test.jar 的时候，你会发现提示如下：

target java -jar maven-test.jar
maven-test.jar中没有主清单属性

原因

首先分析下两个的 maven log。

spring-boot-starter-parent作为parent

spring-boot-dependencies作为parent

可以看到第二次的打包插件是 maven-jar-plugin，也就是说 springboot 的项目一些资源并没有打包进来，查看 spring-boot-maven-plugin 插件，发现它是来自于 spring-boot-starter-parent 里面的，但是在文章的开头部分，是已经手动的将其引入到了 pom 文件，那么修改 parent 以后未执行的话，最有可能就是版本号的缺失导致的，于是修改pom：

 <plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>2.1.11.RELEASE</version>
    </plugin>
</plugins>
<finalName>maven-test</finalName>

然后运行mvn package：

[INFO] --- spring-boot-maven-plugin:2.1.11.RELEASE:repackage (repackage) @ maven-test ---
[INFO] Replacing main artifact with repackaged archive
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

你会发现此时打包出来的 jar 文件已经可以运行了。

进阶

那么假设项目已经有了自己的 parent，如果还想用 spring-boot-dependencies 来进行统一的一个全局版本控制，那么有如下的解决办法

在自己的parent中设置parent为 spring-boot-starter-parent，那么根据 maven 的继承属性，所有的 子pom 也就顺带继承了 spring-boot-starter-parent