这篇文章的目标是一个有趣但非常强大的概念:将应用程序打包为单个可运行的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