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