關於 maven 打包直接運行的 fat jar (uber jar) 時須要包含本地文件系統第三方 jar 文件的問題

關於maven打包fat jar (uber jar) 時須要包含本地文件系統第三方jar文件的問題，今天折騰了一成天。最後仍是用了spring boot來作。下面是幾篇關於打包的有參考價值的文章，以及個人解決方法。

 

參考文章：

1.  將 Spring boot 項目打成可執行Jar包，及相關注意事項（main-class、缺乏 xsd、重複打包依賴）　　https://blog.csdn.net/rainbow702/article/details/55096506

 

2.  Java 打包 FatJar 方法小結　　https://yq.aliyun.com/articles/631100

   （此文說明了Unshaded，Shaded 和 jar of jars 的區別和方法，其中提到了 jar of jars 的工具備 Onejar Maven Plugin 和 下面的 spring boot plugin）

　　

3.  maven打包可運行的fat-jar的簡單方法　　http://www.javashuo.com/article/p-bfavsxsw-gt.html   

     (此處兩種方法均沒法包含本地jar，下面就是關於如何在第二種方法中加入本地jar的選項。對於assembly，或者maven shade插件，我都還搞不清楚如何把本地jar包進去，或者包進去後如何被查找到。有知道的同窗麻煩留言告知，不勝感激！)

 

我採用的方法：

最後的pom.xml文件，其中的gson是測試maven repo的依賴，mxGraph是測試本地jar文件的依賴 ：

<?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>com.pekkle</groupId>
    <artifactId>test-maven</artifactId>
    <version>1.0-SNAPSHOT</version>

    <name>${artifactId}</name>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <dependencies>

        <!--這個是maven repo中的dependency-->
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.8.5</version>
        </dependency>

        <!--這個是本地文件系統中的dependency，groupId和artifactId和version其實都是能夠本身隨便編一個的-->
        <!--systemPath就是指向本地jar文件，${basedir}指向pom.xml文件所在的目錄-->
        <dependency>
            <groupId>com.jgraph</groupId>
            <artifactId>abctest</artifactId>
            <version>3.9.11</version>
            <scope>system</scope>
            <systemPath>${basedir}/src/lib/mxgraph-all.jar</systemPath>
        </dependency>

    </dependencies>

    <build>
        <finalName>${artifactId}</finalName>

        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <!--本身寫的應用的主類-->
                    <mainClass>com.pekkle.App</mainClass>
                    <!--能包含本地文件系統的jar包的關鍵-->
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <!--必須repackage纔會生成最終的fat jar-->
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

 

生成的jar最後直接運行： java -jar ./target/test-maven.jar  ， 沒有其餘依賴。

 

總結：

本地文件的scope 「system」 是被反對使用的，由於這樣的文件是遊離在maven repo以外。雖然能夠經過安裝到內網的Nexus倉庫，或者安裝到本機的repo倉庫來提供依賴座標，可是對於偶爾須要用到第三方jar，又須要整合到mvn package過程的需求來講，彷佛仍是須要這樣一條路徑。