Maven把專案依賴的所有jar包都打到同一個jar中

Java菜分享發表於2019-03-30
MavenJAR

1 使用maven-shade-plugin

(1) 在專案的pom.xml檔案中加入如下外掛:

    <build>
        <plugins>
            <!-- Maven Shade Plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <createDependencyReducedPom>true</createDependencyReducedPom>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <!-- 主類的全限定名 -->
                                    <mainClass>com.healchow.consumer.Main</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
複製程式碼

(2) 然後使用Maven的package命令打包專案;

(3) 打包完成後, 即可在專案的target目錄下看到生成的jar包;

(4) 不出差錯的話, 使用java -jar xxxx.jar命令即可執行此jar包.

說明: 此方法在Mac OS系統下的IDEA中實施, 在jar/META-INF/目錄下有時會出現:

ECLIPSEF.SF ECLIPSE.RSA等檔案, 並在執行java -jar xxx.jar時, 會丟擲如下錯誤:

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.SecurityException: Invalid signature file digest for Manifest main attributes
        at sun.security.util.SignatureFileVerifier.processImpl(SignatureFileVerifier.java:330)
        at sun.security.util.SignatureFileVerifier.process(SignatureFileVerifier.java:263)
        at java.util.jar.JarVerifier.processEntry(JarVerifier.java:318)
        at java.util.jar.JarVerifier.update(JarVerifier.java:230)
        at java.util.jar.JarFile.initializeVerifier(JarFile.java:383)
        at java.util.jar.JarFile.getInputStream(JarFile.java:450)
        at sun.misc.URLClassPath$JarLoader$2.getInputStream(URLClassPath.java:977)
        at sun.misc.Resource.cachedInputStream(Resource.java:77)
        at sun.misc.Resource.getByteBuffer(Resource.java:160)
        at java.net.URLClassLoader.defineClass(URLClassLoader.java:454)
        at java.net.URLClassLoader.access$100(URLClassLoader.java:73)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:368)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:362)
        at java.security.AccessController.doPrivileged(Native Method)
        at java.net.URLClassLoader.findClass(URLClassLoader.java:361)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:335)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
        at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:495)
複製程式碼

解決辦法是: 手動刪除jar包中META-INF/*.RSA META-INF/*.DSA META-INF/*.SF這些檔案, 然後就可行了.

2 推薦: 使用maven-assembly-plugin

(1) 在專案的pom.xml檔案中加入如下外掛:

     <build>
        <plugins>
            <!-- Maven Assembly Plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>2.4.1</version>
                <configuration>
                    <!-- get all project dependencies -->
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <!-- MainClass in mainfest make a executable jar -->
                    <archive>
                        <manifest>
                            <mainClass>com.healchow.consumer.Main</mainClass>
                        </manifest>
                    </archive>
                </configuration>
                <executions>
                    <!-- 配置執行器 -->
                    <execution>
                        <id>make-assembly</id>
                        <!-- 繫結到package命令的生命週期上 -->
                        <phase>package</phase>
                        <goals>
                            <!-- 只執行一次 -->
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
         </plugins>
     </build>
複製程式碼

(2) 然後使用Maven的package命令打包專案;

(3) 打包完成後, 即可在專案的target目錄下看到生成的jar包, 其中xxx-jar-with-dependencies.jar是包含依賴jar包的jar檔案, 另一個不包含依賴jar包;

(4) 使用java -jar xxxx.jar命令即可執行此jar包.

3 擴充套件: Maven安裝本地jar包到本地倉庫

命令如下:

mvn install:install-file -Dfile=base-util-1.0.RELEASE.jar -DgroupId=com.healchow -DartifactId=base-util -Dversion=1.0.RELEASE -Dpackaging=jar
複製程式碼

其他命令, 參考這篇部落格: Maven常用命令.

4 擴充套件: 手動生成jar包

建立可執行 jar 包的關鍵在於：讓java -jar命令知道 jar 包中的主方法屬於哪個類 —— 要配置主類的全限定名.

步驟如下:

(1) 打包指定的專案:

進入專案所在的根目錄, 以Linux系統為例:

專案名是java-test, 其所在的目錄是/data/project/java-test;main方法所屬的類的全限定名是com.healchow.test.Main:
# 進入專案所在的根目錄:
cd /data/project
# 執行打包命令: 
jar  cvfe  test.jar  java-test.com.healchow.test.Main  java-test 
複製程式碼

上述命令說明: 將java-test目錄下的所有檔案打包到test.jar中, 並指定主類的全限定名稱, 這裡要指明主類所在的資料夾.

關於jar命令的其他用法, 參考如下:
# 用法: jar {ctxui}[vfmn0PMe] [jar-file] [manifest-file] [entry-point] [-C dir] files ...
# 選項:
 -c  建立新檔案
 -t  列出檔案目錄
 -x  從檔案中提取指定的 (或所有) 檔案
 -u  更新現有檔案
 -v  在標準輸出中生成詳細輸出
 -f  指定檔案檔名
 -m  包含指定清單檔案中的清單資訊
 -n  建立新檔案後執行 Pack200 規範化
 -e  為捆綁到可執行 jar 檔案的獨立應用程式指定應用程式入口點
 -0  僅儲存; 不使用任何 ZIP 壓縮
 -P  保留檔名中的前導 '/' (絕對路徑) 和 ".." (父目錄) 元件
 -M  不建立條目的清單檔案
 -i  為指定的 jar 檔案生成索引資訊
 -C  更改為指定的目錄幷包含以下檔案
# 如果任何檔案為目錄, 則對其進行遞迴處理。
# 清單檔名, 檔案檔名和入口點名稱的指定順序 與 'm', 'f' 和 'e' 標記的指定順序相同。
示例 1: 將兩個類檔案歸檔到一個名為 classes.jar 的檔案中: 
    jar cvf classes.jar Foo.class Bar.class 
示例 2: 使用現有的清單檔案 'mymanifest' 並將 foo/ 目錄中的所有檔案歸檔到 'classes.jar' 中: 
    jar cvfm classes.jar mymanifest -C foo/ .
複製程式碼

(2) 執行jar包:

用解壓軟體開啟上一步生成的jar包, 檢視META-INF/MANIFEST.MF檔案, 裡面如果有Main-Class: com.healchow.test.Main, 說明打包成功.

# 在當前目錄下, 執行jar包: 
java -jar test.jar
複製程式碼

5 擴充套件: Linux下執行jar包的幾種方式

5.1 阻塞式方式

java -jar xxx.jar
複製程式碼

特點: 當前終端的會話視窗被阻塞, 可按CTRL + C中斷程式的執行, 或者直接關閉會話視窗 —— 此時jar程式將終止.

5.2 後臺執行方式

# 通過"&"符號實現後臺執行: 
java -jar xxx.jar &
複製程式碼

特點: 當前終端的會話視窗不會被阻塞, 但是如果關閉當前視窗, 程式將終止執行.

5.3 後臺持續執行方式

# 通過"nohup"命令實現後臺執行: 
nohup java -jar xxx.jar &
複製程式碼

nohup命令是不結束通話執行命令的意思.

特點: 當使用者退出或終端關閉時, 程式的執行不受影響.

說明: 用nohup命令執行任務時, 預設情況下這個任務的所有輸出都將被重定向到nohup.out檔案中, 除非另外指定輸出檔案. 指定輸出檔案方式為:

# 將輸出重定向到xxx.log檔案中: 
nohup java -jar xxx.jar > xxx.log &
複製程式碼

> 符號是重定向符, 實現: 把它之前命令的所有輸出資訊重定向到後面的檔案中, 而不是顯示到螢幕上.

5.4 其他命令擴充套件

① 通過jobs命令可以檢視後臺執行任務, 會給每個任務指定一個編號.

② 通過fg命令可以把指定編號的後臺任務調回到前臺控制, 如: fg 10 —— 把10號任務調回前臺.

③ 檢視佔用某個埠的程式:

netstat -nlp | grep 2181
# 下述結果說明程式號pid=18434的java程式佔用了2181埠
tcp        0      0 :::2181          :::*           LISTEN      18434/java
複製程式碼

歡迎工作一到五年的Java工程師朋友們加入Java程式設計師開發： 721575865

群內提供免費的Java架構學習資料（裡面有高可用、高併發、高效能及分散式、Jvm效能調優、Spring原始碼，MyBatis，Netty,Redis,Kafka,Mysql,Zookeeper,Tomcat,Docker,Dubbo,Nginx等多個知識點的架構資料）合理利用自己每一分每一秒的時間來學習提升自己，不要再用"沒有時間“來掩飾自己思想上的懶惰！趁年輕，使勁拼，給未來的自己一個交代！



相關文章