這篇文章的目標是一個有趣但非常強大的概念:將應用程序打包為單個可運行的JAR文件,也稱為一個或胖 JAR文件。
我們習慣了大型WAR歸檔文件,其中包含所有打包在某些公用文件夾結構下的依賴項。 使用類似于JAR的打包,情況有所不同:為了使您的應用程序可運行(通過java -jar ),所有依賴項都應通過classpath參數或環境變量提供。 通常,這意味著將存在一些具有所有依賴項的lib文件夾和一些可運行的腳本 ,這些腳本將完成構造類路徑和運行JVM的工作。 Maven Assembly插件因進行這種應用程序分發而聞名。
稍微不同的方法是將所有應用程序依賴項打包到同一JAR文件中,并使其可運行,而無需任何其他參數或腳本。 聽起來不錯,但是……除非您添加一些魔力,否則它將無法正常工作:滿足One-JAR項目。
讓我們簡要概述一下問題:我們正在編寫一個獨立的Spring應用程序,只需鍵入java -jar <our-app.jar>即可運行該應用程序。
和往常一樣,讓我們??從我們的POM文件開始,這將非常簡單
<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.example</groupid><artifactid>spring-one-jar</artifactid><version>0.0.1-SNAPSHOT</version><packaging>jar</packaging><name>spring-one-jar</name><url>http://maven.apache.org</url><properties><project.build.sourceencoding>UTF-8</project.build.sourceencoding><org.springframework.version>3.1.1.RELEASE</org.springframework.version></properties><dependencies><dependency><groupid>cglib</groupid><artifactid>cglib-nodep</artifactid><version>2.2</version></dependency><dependency><groupid>org.springframework</groupid><artifactid>spring-core</artifactid><version>${org.springframework.version}</version></dependency><dependency><groupid>org.springframework</groupid><artifactid>spring-context</artifactid><version>${org.springframework.version}</version></dependency></dependencies>
</project>
我們的示例應用程序將引導Spring上下文,獲取一些bean實例并在其上調用一個方法。 我們的bean叫做SimpleBean ,看起來像:
package com.example;
public class SimpleBean {public void print() {System.out.println( 'Called from single JAR!' );}
}
愛上Spring Java配置,讓我們將上下文定義為帶注釋的AppConfig POJO:
package com.example.config;import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;import com.example.SimpleBean;@Configuration
public class AppConfig {@Beanpublic SimpleBean simpleBean() {return new SimpleBean();}
}
最后,我們的應用程序Starter與main() :
package com.example;import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;import com.example.config.AppConfig;public class Starter {public static void main( final String[] args ) {ApplicationContext context = new AnnotationConfigApplicationContext( AppConfig.class );SimpleBean bean = context.getBean( SimpleBean.class );bean.print();}
}
將我們的主類添加到META-INF / MANIFEST.MF可以利用Java功能來運行JAR文件,而無需使用main()方法顯式指定類。 Maven JAR插件可以幫助我們。
<build><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-jar-plugin</artifactid><configuration><archive><manifest><mainclass>com.example.Starter</mainclass></manifest></archive></configuration></plugin></plugins>
</build>
嘗試運行java -jar spring-one-jar-0.0.1-SNAPSHOT.jar會將異常輸出到控制臺: java.lang.NoClassDefFoundError 。 原因很簡單:即使是這樣一個簡單的應用程序,也已經要求以下庫位于類路徑中。
aopalliance-1.0.jar
cglib-nodep-2.2.jar
commons-logging-1.1.1.jar
spring-aop-3.1.1.RELEASE.jar
spring-asm-3.1.1.RELEASE.jar
spring-beans-3.1.1.RELEASE.jar
spring-context-3.1.1.RELEASE.jar
spring-core-3.1.1.RELEASE.jar
spring-expression-3.1.1.RELEASE.jar
讓我們在這里看看One-JAR可以為我們做些什么。 由于onejar-maven-plugin的可用性,我們可以在我們的POM文件的plugins部分中添加一個。
<plugin><groupid>org.dstovall</groupid><artifactid>onejar-maven-plugin</artifactid><version>1.4.4</version><executions><execution><configuration><onejarversion>0.97</onejarversion><classifier>onejar</classifier></configuration><goals><goal>one-jar</goal></goals></execution></executions>
</plugin>
另外, pluginRepositories部分應包含此存儲庫以便下載插件。
<pluginrepositories><pluginrepository><id>onejar-maven-plugin.googlecode.com</id><url>http://onejar-maven-plugin.googlecode.com/svn/mavenrepo</url></pluginrepository>
</pluginrepositories>
結果, 目標文件夾中將提供另一個工件,后綴有one-jar : spring-one-jar-0.0.1-SNAPSHOT.one-jar.jar 。 使用java -jar spring-one-jar-0.0.1-SNAPSHOT.one-jar.jar運行此命令將打印到控制臺:
Called from single JAR!
完全可運行的Java應用程序,作為單個可再發行的JAR文件! 最后的評論:盡管我們的應用程序看起來很簡單,但是One-JAR也可以完美地用于復雜的大型應用程序。 請把它添加到您的工具箱中,它是非常有用的工具。
感謝One-JAR伙計們!
參考: 簡單但功能強大的概念:在Andriy Redko {devmind}博客上,從我們的JCG合作伙伴 Andrey Redko 將Java應用程序打包為一個(或胖)JAR 。
翻譯自: https://www.javacodegeeks.com/2012/11/packing-your-java-application-as-one-or-fat-jar.html