mvn 打包可执行包_使用MAVEN打包可执行的jar包

说明

非web项目中经常遇到需要将工程打包成一个可执行jar包(通过在命令行执行java命令进行启动)的情000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000况。

一个可执行的jar包,需要满足以下条件:

在jar包中的/META-INF/MANIFEST.MF元数据文件中必须保护Main-Class启动入口类信息

项目的所有依赖都必须包含在Classpath中。即依赖必须都被描述MANIFEST于.MF文件中的Class-Path下

Maven中可以通过许多插件完成打包任务,如强大的maven-assembly-plugin等。具体使用方式,可以参见各插件的说明。

基础概念:maven的生命周期与插件

Maven将工程的构建过程分为不同的生命周期(LifeCycle),每个生命周期中又划分为不同的阶段(Phase)。

LifyCycle之间互相独立,且没有明确的顺序关系,而每个LifeCycle中的Phase间则存在明确的顺序关系,且必须依序执行。

Maven内置了三个LifyCycle,如default(build)构建,clean清理, site生成文档与站点。

以default为例,其内置的phase主要包含有: validate,compile,test,package,intergration-test,verify,install,deploy.这些phase在项目build时会依次执行 。

Maven所定义的LifeCycle与Phase只是抽象的概念,不涉及具体的功能。而功能的实现则由插件(Plugin)负责。

一个Plugin可以实现多个目标(Goal), Goal可以绑定在多个Phase上, 每个Phase下也可以包含多个Goal。可以将Phase视为Goal的容器。

Goal是Maven里面最小的任务单位,相关于Ant的target。Goal与Goal之间是互相独立的。单独执行某个Goal不会导致其他Goal被执行。

当我们对一个工程执行打包命令mvn package时, maven将从validate阶段开始,一个阶段一个阶段(compile, test)的执行,直至到达package阶段。

在执行到compile阶段时,插件maven-compiler-plugin的compile goal会被执行,因为这个goal是绑定在compile阶段。

同理,当执行到package阶段时,插件maven-dependency-plugin与maven-resources-plugin的相关goal都会被执行。

工程打包示例

目录结构示例

project/

+ src/main/java/

+ com.some.package

+ src/main/resources/

- settings.properties

- applicationContext.xml

- startup.bat

- pom.xml

打包后的期望结果

target/

+ conf/

- settings.properties

- applicationContext.xml

+ lib/

- project.jar

- startup.bat

project.jar中不包含配置文件。

pom文件中打包相关的配置

org.apache.maven.plugins

maven-compiler-plugin

2.3.2

1.6

1.6

UTF-8

${java.home}/lib/rt.jar

org.apache.maven.plugins

maven-dependency-plugin

${project.build.directory}/lib

false

false

copy-dependencies

package

copy-dependencies

${project.build.directory}/lib

false

false

org.apache.maven.plugins

maven-resources-plugin

2.6

copy-resources

package

copy-resources

UTF-8

${project.build.directory}/conf

src/main/resources/

true

*.bat

copy-command

package

copy-resources

UTF-8

${project.build.directory}

src/main/resources/

true

*.bat

org.apache.maven.plugins

maven-jar-plugin

2.4

true

lib/

com.some.package.some.class.Main

conf/

**/*.class

org.eclipse.m2e

lifecycle-mapping

1.0.0

org.apache.maven.plugins

maven-dependency-plugin

[1.0.0,)

copy-dependencies

打包命令mvn clean package

附录1 启动命令bat文件编写

REM 关闭输出

@echo off

REM 设置启动时使用的jdk。如果不设置,则使用系统变量中设置的jdk

set path=../jdk.1.7.80/bin

set classpath=../jdk.1.7.80/jre/lib

REM 最基本的jar包启动命令,使用MANIFEST中的入口类启动

java -jar project.jar

REM 指定jar包的某个类作为入口启动

java -cp project.jar some.package.some.class.MyClass

REM 设置jvm参数并启动jar包

java -Xms256m -Xmx512m -jar project.jar

REM 开启输出

echo on

附录2 maven打包时的文件拷贝

通常打包外部资源文件时,都使用maven-dependency-plugin或是maven-resources-plugin插件。但是项目中遇见一个问题,在打包jnotify的动态链接库时,使用上面两个插件进行文件拷贝时,程序会无法识别到打包后dll文件。

多次尝试后使用了maven-antrun-plugin进行拷贝,问题得到解决。其拷贝配置如下:

org.apache.maven.plugins

maven-antrun-plugin

1.7

copy-native-libraries

package

run


版权声明:本文为weixin_32401763原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。