maven项目如何打包运行指定java程序(maven-shade-plugin插件的使用)
其实maven项目的打包就是将项目代码打包成可执行文件,在maven中有默认的打包插件,但是想要运行指定java程序就要使用maven-shade-plugin
插件
maven-jar-plugin
是maven的默认打包插件,用来创建 project jar
maven-shade-plugin
用来打可执行包,包含依赖,以及对依赖进行取舍过滤
1 maven-shade-plugin介绍
maven-plugin-shade 插件提供了两个主要的能力:
- 把整个项目(包含它的依赖)都打包到一个 “uber-jar” 中;
- shade - 即重命名某些依赖的包。
具体来说,它提供了以下功能:
- 按需选择要添加到最终 jar 包中依赖;
- 重定位 class 文件;
- 生成可执行 jar 包;
- 生成项目资源文件。
2 基本用法
maven-plugin-shade 必须和 Maven 构建生命周期中的 package 阶段绑定,
也就是说,当执行mvn package
时会自动触发 shade
。
要使用 maven-plugin-shade,只需要在 pom.xml 的 < plugins > 标签下添加它的配置即可,示例如下:
<project>...<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-shade-plugin</artifactId><version>3.2.4</version><executions><execution><!-- 和 package 阶段绑定 --><phase>package</phase><goals><goal>shade</goal></goals></execution></executions><configuration><!-- 此处按需编写更具体的配置 --></configuration></plugin></plugins></build>...
</project>
项目中常用写法
<?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"><!--xxx--><build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <!--<version>3.2.4</version>--><version>1.4</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <!--在打包时将jar包中的内容排除--><filters> <filter> <artifact>*:*</artifact> <excludes> <exclude>META-INF/*.SF</exclude> <exclude>META-INF/*.DSA</exclude> <exclude>META-INF/*.RSA</exclude> </excludes> </filter> </filters> <transformers> <!--java -jar 默认启动的主类--><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>cn.fileserver.HttpFileServer</mainClass> </transformer> <!--处理多个jar包中存在重名的配置文件的合并--><transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer"> <resource>META-INF/spring.handlers</resource> </transformer> <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer"> <resource>META-INF/spring.schemas</resource> </transformer> </transformers> </configuration> </execution> </executions> </plugin> </plugins>
</build> </project>
3 常用功能
3.1 按需选择需要添加到最终 jar 包中依赖
3.1.1 使用<filter>
使用<filter>
结合 & 标签在打包,可实现更灵活的依赖选择。它是以groupId:artifactId
为标识,在filter内部可以使用 / 更细致地控制,既可以移除代码文件,也可以移除配置文件,示例如下:
<!-- 按package过滤junit包 -->
<configuration><filters><filter><!--junit:junit包,也可以*:*涵括所有包--><artifact>junit:junit</artifact><!--包含--><includes><include>junit/framework/**</include><include>org/junit/**</include></includes><!--排除--><excludes><exclude>org/junit/experimental/**</exclude><exclude>org/junit/runners/**</exclude></excludes></filter></filters>
</configuration>
3.1.2 使用<artifactSet>
使用 <artifactSet>
排除不需要的依赖,指定 groupId:artifactId 的标识,示例如下:
<configuration><artifactSet><excludes><exclude>classworlds:classworlds</exclude><exclude>junit:junit</exclude><exclude>jmock:*</exclude><exclude>*:xml-apis</exclude><exclude>org.apache.maven:lib:tests</exclude><exclude>log4j:log4j:jar:</exclude></excludes></artifactSet>
</configuration>
3.3.3 使用<minimizeJar>
除了可以通过自定义的 filters 来过滤依赖,此插件还支持自动移除项目中没有使用到的依赖,以此来最小化 jar 包的体积,只需要添加一项配置即可。示例如下:
建议maven-shade-plugin的版本为3.2.4,低版本会报错
<configuration><minimizeJar>true</minimizeJar>
</configuration>
3.2 重定位 class 文件
如果最终的 jar 包被其他的项目所依赖的话,直接地引用此 jar 包中的类可能会导致类加载冲突,这是因为 classpath 中可能存在重复的 class 文件。为了解决这个问题,我们可以使用 shade 提供的重定位功能,把部分类移动到一个全新的包中。示例如下:
涉及标签:
<pattern>:原始包名
<shadedPattern>:重命名后的包名
<excludes>:原始包内不需要重定位的类,类名支持通配符<configuration><relocations><relocation><pattern>org.codehaus.plexus.util</pattern><shadedPattern>org.shaded.plexus.util</shadedPattern><excludes><exclude>org.codehaus.plexus.util.xml.Xpp3Dom</exclude><exclude>org.codehaus.plexus.util.xml.pull.*</exclude></excludes></relocation></relocations>
</configuration>
在上述示例中,我们把 org.codehaus.plexus.util 包内的所有子包及 class 文件(除了 ~.xml.Xpp3Dom 和 ~.xml.pull 包下的所有 class 文件)重定位到了 org.shaded.plexus.util 包内。
当然,如果包内的大部分类我们都不需要,一个个排除就显得很繁琐了。此时我们也可以使用<includes>
标签来指定我们仅需要的类,示例如下:
<project>...<relocation><pattern>org.codehaus.plexus.util</pattern><shadedPattern>org.shaded.plexus.util</shadedPattern><includes><include>org.codehaud.plexus.util.io.*</include></includes></relocation>...
</project>
3.3 生成可执行 jar 包指定启动类
使用 maven-plugin-shade 后,最终生成的 jar 包可以包含所有项目所需要的依赖。
我们会想,能不能直接运行这个 uber-jar 呢?
答案是当然可以,并且十分简单,只需要指定<mainClass>
启动类,然后java -jar jar包
就可以了。示例如下:
<project>...<configuration><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass>cn.fileserver.HttpFileServer</mainClass></transformer></transformers></configuration>...
</project>
3.4 生成可执行 jar 包不指定启动类
在打包后,有可能有多个mainClass,那么就可以在pom.xml中不指定<mainClass>
启动类,然后通过java -cp jar包 全路径类名
启动即可
<project>...<configuration><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass></mainClass></transformer></transformers></configuration>...
</project>
3.5 定制 MANIFEST.MF 文件
熟悉 jar 包的朋友们都知道,jar 包中在META-INF中默认会包含一个 MANIFEST.MF 文件
MANIFEST.MF
Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Built-By: lvxy
Created-By: Apache Maven 3.8.1
Build-Jdk: 1.8.0_261
Main-Class: cn.fileserver.HttpFileServer
里面描述了一些 jar 包的信息。使用 java 自带的 jar 命令打包的时候可以指定 MANIFEST.MF,其中也可以指定 Main-Class 来使得 jar 包可运行。那么使用 shade 来指定和直接在 MANIFEST.MF 文件中指定有什么区别呢?
答案是没有区别,细心的读者会发现 <mainClass>
标签的父标签是<transformer>
有一个implementation
属性,其值为 "~.ManifestResourceTransformer"
,意思是 Manifest 资源文件转换器。上述示例只自指定了启动类,因此 shade 会为我们自动生成一个包含 Main-Class 的 MANIFEST.MF
文件,然后在打 jar 包时指定这个文件。
那如果我们想要完全定制 MANIFEST.MF 文件内容怎么办呢?我们可以使用<manifestEntries>
标签,示例如下:
<project>...<configuration><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><manifestEntries><Main-Class>cn.fileserver.HttpFileServer</Main-Class><Build-Number>123</Build-Number></manifestEntries></transformer></transformers></configuration>...
</project>
此时的 MANIFEST.MF
Manifest-Version: 1.0
Build-Number: 123
Archiver-Version: Plexus Archiver
Built-By: lvxy
Created-By: Apache Maven 3.8.1
Build-Jdk: 1.8.0_261
Main-Class: cn.fileserver.HttpFileServer
4 生成资源文件
项目中涉及到的依赖可能会有它们所必需的资源文件,使用 shade 可以把它们聚合在同一个 jar 包中。
默认地,shade 为我们提供了 12 个 ResourceTransformer 类:
类名 | 作用 |
---|---|
ApacheLicenseResourceTransformer | 防止 LICENSE 文件重复 |
ApacheNoticeResourceTransformer | 准备合并的 NOTICE |
AppendingTransformer | 为某个资源文件附加内容 |
ComponentsXmlResourceTransformer | 聚合 Plexus components.xml |
DontIncludeResourceTransformer | 防止包含指定的资源 |
GroovyResourceTransformer | 合并 Apache Groovy 的扩展模块 |
IncludeResourceTransformer | 添加项目中的文件为资源文件 |
ManifestResourceTransformer | 自定义 MANIFEST 文件 |
PluginXmlResourceTransformer | 聚合 Maven 的 plugin.xml 配置 |
ResourceBundleAppendingTransformer | 合并 ResourceBundles |
ServicesResourceTransformer | 重定位且合并 META-INF/services 资源文件中的 class 文件. |
XmlAppendingTransformer | 为 XML 资源文件附加内容 |
这里介绍一些常用的Transformer,
更多的Transformer见:
http://maven.apache.org/plugins/maven-shade-plugin/examples/resource-transformers.html
4.1 ManifestResourceTransformer
往MANIFEST文件中写入Main-Class是可执行包的必要条件。ManifestResourceTransformer可以轻松实现。
<configuration><transformers><transformerimplementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass>com.lcifn.Application</mainClass></transformer></transformers>
</configuration>
4.2 AppendingTransformer
用来处理多个jar包中存在重名的配置文件的合并,尤其是spring。
<configuration><transformers><transformerimplementation="org.apache.maven.plugins.shade.resource.AppendingTransformer"><resource>META-INF/spring.handlers</resource></transformer><transformerimplementation="org.apache.maven.plugins.shade.resource.AppendingTransformer"><resource>META-INF/spring.schemas</resource></transformer></transformers>
</configuration>
4.3 ServicesResourceTransformer
JDK的服务发现机制是基于META-INF/services/目录的,如果同一接口存在多个实现需要合并 ,则可以使用此Transformer。
<configuration><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/></transformers>
</configuration>
5 原始构件与shade构件
默认情况下,shade插件会覆盖基于项目的jar包,而生成包含所有依赖的jar包。但有时需要原始的jar包和shade后的jar包同时被部署,可以配置如下。
<configuration><shadedArtifactAttached>true</shadedArtifactAttached><!-- 名称会作为后缀在shade构件jar包后 --><shadedClassifierName>exec</shadedClassifierName>
</configuration>
参考文章:
https://blog.51cto.com/u_15127499/2672787
https://blog.csdn.net/iflink/article/details/122389637
maven项目如何打包运行指定java程序(maven-shade-plugin插件的使用)相关推荐
- IDEA 运行maven项目时出错:Error java:错误: 不支持发行版本 XXX 5,12,14等
IDEA 运行maven项目时出错:Error : java:错误: 不支持发行版本 5 java学习笔记 报错截图 错误说明 [Error : java:错误: 不支持发行版本 5]错误是因为jav ...
- IDEA中MAVEN项目如何打包JAR包
这篇文章主要为大家展示了"IDEA中MAVEN项目如何打包JAR包",内容简而易懂,条理清晰,希望能够帮助大家解决疑惑,下面让小编带领大家一起研究并学习一下"IDEA中M ...
- paurse java_在eclipse中通过RSE插件运行远程java程序时遇到问题
我花了很多时间来确定如何使用RSE插件从本地 Eclipse运行远程Java程序. 我能够通过使用RSE的eclipse连接到我的远程机器,在远程系统资源管理器透视图上在eclipse上的远程mave ...
- 编译运行一个java程序_如何从另一个Java程序编译和运行Java程序
编译运行一个java程序 Have you ever thought if it's possible to compile and run a java program from another j ...
- 在任意的远程桌面的session中运行指定的程序
//在其它session中(如远程桌面的session)运行指定的程序,需要具有system权限,可以在任意的桌面里运行指定程序#include <windows.h> #include ...
- 解决idea中maven项目无法读取src/main/java目录下面的配置文件问题
解决idea中maven项目无法读取src/main/java目录下面的配置文件问题 参考文章: (1)解决idea中maven项目无法读取src/main/java目录下面的配置文件问题 (2)ht ...
- linux如何运行java程序,Linux环境下运行简单java程序
一.安装java 1.下载jdk8 选择对应jdk版本下载.(Tips:可在Windows下载完成后,通过FTP或者SSH到发送到Linux上) 2. 登录Linux,切换到root用户 su roo ...
- 一步控制台编译java_在控制台运行一个 Java 程序 Test . class ,使用的命令正确的是( )_学小易找答案...
[多选题]城市轨道交通自动售检票系统架构包括 [填空题]区域式架构是在( )和( )基础上设置的一个路网中心 [填空题]在危险.安全.喜庆.阴霾等不同气氛下的场景色彩基调是__________. [单 ...
- 数据库Java项目:在线租房出租房屋系统(java+springboot+maven+mysql)
数据库Java项目:在线租房出租房屋系统(java+springboot+maven+mysql) 主要实现了客户在线租房及房东发布出租等基本操作流程的全部功能,系统分普通用户.房东.管理员等角色,除 ...
最新文章
- 罗辑思维年终4小时演讲《时间的朋友》1000字浓缩版
- [leetcode] 198.打家劫舍
- ios device provisioning
- Android Studio使用心得
- linux 单例模式改密码,Java 利用枚举实现单例模式
- [剑指offer][JAVA]面试题第[10-2]题[青蛙跳台阶问题][动态规划][递归]
- linux 改目录前缀,Linux修改终端显示前缀及环境变量
- Mybatis源码分析开篇
- 合并多个python list以及合并多个 django QuerySet 的方法
- Google Jump Consistent Hash 一致性哈希算法
- atitit.修复xp 操作系统--重装系统--保留原来文件不丢失
- SAP物料主数据编码范围配置
- JS数组常用方法练习题
- 二叉树先序遍历、中序遍历、后序遍历 递归和非递归算法
- 关于前端 后端 数据库 时间的设置与传递
- python之scrapy:第一只spider
- 田忌赛马java lms_【044】:田忌赛马
- 怎么做好一件复杂的事情 No.201
- 爬虫百战(四)——爬取yy短视频
- 什么是知识库?企业知识库都写什么?
热门文章
- 这是“我”的故事 —— 崔晨洋
- pandas读取csv、txt和xlsx文件
- divi模板下载_赞助商:Divi 3.0
- android树状结构导航图
- 申请去美国读博士条件有哪些
- 【Python】pd.set_option()的效果与解析
- 总结一下《17天搞定GRE单词》的方法
- 用迭代和递归方式分别写一个兔子生育的python程序(斐波那契数列)
- 安卓毕业设计-图书馆管理系统-新手练手项目
- java 分卷压缩_Apache Commons Compress介绍-Zip压缩解压