开发者

解读maven项目的打包方式

开发者 https://www.devze.com 2024-08-13 10:23 出处:网络 作者: 程序员阿伟
目录前言概念准备打包方式idea自带的maven工具小包总结大包打包maven-compiler-pluginmaven-jar-plugin 和 maven-dependency-pluginmaven-assembly-pluginmaven-shade-plugin两种第三方插件打包方式的总结前言
目录
  • 前言
  • 概念
  • 准备
  • 打包方式
    • idea自带的maven工具
    • 小包总结
  • 大包打包
    • maven-compiler-plugin
  • maven-jar-plugin 和 maven-dependency-plugin
    • maven-assembly-plugin
      • maven-shade-plugin
        • 两种第三方插件打包方式的总结

          前言

          现在都是使用idea中maven插件来打包项目,因此此文章将基于idea中的maven插件打包。

          概念

          打包分为小包和大包两种概念:

          • 小包:只打包我们写的代码,不打包代码依赖的其他jar包。
          • 大包:打包项目本身的代码以及项目所依赖的其他jar包。

          因此,如果我们的项目代码只需要被别的代码引用,也就是不需要启动类去运行,那么打包成小包即可,如果我们的项目需要独立的运行,需要启动类去运行,那么就需要打包成大包。

          准备

          我们先创建一个maven项目,创建一个启动类,随便引入一个其他依赖。

          解读maven项目的打包方式

          启动类

          解读maven项目的打包方式

          pom文件

          解读maven项目的打包方式

          打包方式

          idea自带的maven工具

          首先使用idea中自带的maven工具打包,idea的maven工具也能打大包和小包。

          小包打包第一种方式

          小包打包直接运行maven中的package即可。

          解读maven项目的打包方式

          可以看到target目录下生成了jar包

          解读maven项目的打包方式

          查看生成的jar包

          解读maven项目的打包方式

          可以看到只有我们项目的代码,引入的依赖并没有被一起打包

          解读maven项目的打包方式

          这里也就不测试能不能通过命令Java -jar *.jar 去运行jar包了,因为这是小包,根据小包的作用,我们是并不需要去运行。

          这里我可以告诉你,并不能运行,因为我们打包的时候并没有去指定启动类的路径,也就是在META-INF目录下的MANIFEST.MF文件中指www.devze.com定启动类。

          解读maven项目的打包方式

          小包打包第二种方式

          大包打包我们是需要指定启动类并且将其他依赖一起打包的。

          解读maven项目的打包方式

          配置打包信息

          解读maven项目的打包方式

          解读maven项目的打包方式

          解读maven项目的打包方式

          配置完后,我们可以看到引入的依赖也在被打包的范围,同时如果我们不想打包某个jar包进来,可以在此面板选择删除,这样就不会一同被打包了。

          解读maven项目的打包方式

          解读maven项目的打包方式

          然后去编译打包

          解读maven项目的打包方式

          解读maven项目的打包方式

          解读maven项目的打包方式

          可以看到生成了out输出文件夹,并且引入的依赖也一同被打包到同个目录下了,但是还是没有合并成同一个jar,如果要运行的话,必须将依赖的jar放在同一个目录中才能正常运行。

          解读maven项目的打包方式

          我们来查看以下生成的jar包

          解读maven项目的打包方式

          我们发现,打包的jar貌似比小包更简洁 ,而且也只有我们本身的java代码,没有MANIFTEST文件,没有的话肯定是无法运行的,因为里面记录启动类的路径以及依赖jar包的存放路径。

          解读maven项目的打包方式

          很奇怪,我们的MANIFEST文件跑到这里了,并没有被一同打包。

          解读maven项目的打包方式

          可以看到MANIFEST中已经生成了jar的存放路径和启动类的路径

          解读maven项目的打包方式

          编程客栈

          原来,我们的这种打包方式必须要和打包插件共同使用,后面会介绍几种打包插件。

          www.devze.com

          这样的打包方式也有解决方法,就是将我们打包的jar解压,将MANIFEST文件放进去再压缩,最后将压缩好的jar包和引入的jar包放在同一个目录中即可运行。

          小包总结

          从 上面的两种方式可以看出来,idea自带的打包方式,只能打包成小包,源码的部分只有项目本身的代码。这种 Jar 包就是所谓的 “小包”。

          大包打包

          从前面来看,打包打包需要使用到第三方插件,以下来介绍一些第三方的打包插件。

          maven-compiler-plugin

          maven-compiler-plugin是一个Maven插件,可以用来指定项目源码的 jdk 版本,编译后的 jdk 版本,以及编码格式。

          单独的使用并不会打包成大包,还是会打成小包,因此一般用来与其他第三方的打包插件联合使用。

          依赖配置

          <build>
                  <plugins>
                      <plugin>
                          <artifactId>maven-compiler-plugin</artifactId>
                          <version>3.8.1</version>
                          <configuration>
                              <!-- 指定maven编译的jdk版本,如果不指定,maven3默认用jdk 1.5 maven2默认用jdk1.3 -->
                              <source>1.8</source> <!-- 源代码使用的JDK版本 -->
                              <target>1.8</target> <!-- 需要生成的目标class文件的编译版本 -->
                              <encoding>UTF-8</encoding><!-- 字符集编码 -->
                          </configuration>
                      </plugin>
                  </plugins>
              </build>

          打包测试

          解读maven项目的打包方式

          http://www.devze.com

          解读maven项目的打包方式

          可以看到只有源码被打包而已。

          maven-jar-plugin 和 maven-dependency-plugin

          这两个插件是一起使用的,首先是不推荐使用这种,此种打包方式有一个比较明显的缺点:打包后会在 target 目录下生成 lib 目录(存放依赖 Jar)和项目 Jar。

          也就是说由于依赖都存在于 lib 目录中,所以要想运行 Jar 包,必须将 Jar 包和 lib 目录放在同一个路径下。

          • maven-jar-plugin

          首先说 maven-jar-plugin 插件,它的思想就是:指定启动类、指定依赖包相对于项目最终 Jar 包所在的路径、给 MANIFEST.MF 文件添加 Class-Path 属性(运行项目 Jar 包时会根据 Class-Path 属性来找到其他依赖 Jar 包的路径),因此这个插件就是个配置 MANIFEST.MF 文件的插件。

          • maven-dependency-plugin

          这个插件才是打包项目的其他依赖,因此这个必须配合上面的插件使用,两者缺一不可。

          依赖配置

          <build>
              <!-- 项目最终打包成的名字 -->
              <finalName>community</finalName>
              <plugins>
                  <plugin>
                      <groupId>org.apache.maven.plugins</groupId>
                      <artifactId>maven-jar-plugin</artifactId>
                      <configuration>
                          <archive>
                              <manifest>
                                  <!-- 会在 MANIFEST.MF 中生成 Class-Path 项 -->
                                  <!-- 系统会根据 Class-Path 项配置的路径加载依赖 -->
                                  <addClasspath>true</addClasspath>
                                  <!-- 指定依赖包所在目录,相对于项目最终 Jar 包的路径 -->
                                  <classpathPrefix>lib/</classpathPrefix>
                                  <!-- 指定 MainClass -->
                                  <mainClass>com.ronz.community.CommunityApplication</mainClass>
                              </manifest>
                          </archive>
                      </configuration>
                  </plugin>
           
                  <!-- 配置依赖包 -->
                  <plugin>
                      <groupId>org.apache.maven.plugins</groupId>
                      <artifactId>maven-dependency-plugin</artifactId>
                      <!-- 相当于执行 mvn 命令,将依赖打包到指定目录 -->
                      <executions>
                          <execution>
                              <id>copy-dependencies</id>
                              <phase>package</phase>
                              <goals>
                                  <goal>copy-dependencies</goal>
                              </goals>
                              <configuration>
                                  <!--将依赖打包至 target 下的 lib 目录-->
                                  <outputDirectory>${project.build.directory}/lib</outputDirectory>
                              </configuration>
                          </execution>
                      </executions>
                  </plugin>
              </plugins>
          </build>

          效果

          解读maven项目的打包方式

          所以说想要运行项目,必须将lib和源码jar包放在同一个目录下才行,这样显然是不太方便的。

          maven-assembly-plugin

          使用 maven-assembly-plugin 插件打出来的包只有一个 Jar 包,这个 Jar 包中包含了项目代码以及依赖的代码。

          也就意味着此种方式打出来的 Jar 包可以直接通过 java -jar xxx.jar 的命令来运行。

          而且我们可以联合maven-compiler-plugin插件来使用。

          缺点

          maven-assembly-plugin 同名类覆盖时会出现问题。

          依赖配置

              <build>
                  <!-- 项目最终打包成的名字 -->
                  <finalName>test</finalName>
                  <plugins>
                      <plugin>
                          <artifactId>maven-compiler-plugin</artifactId>
                          <version>3.8.1</version>
                          <configuration>
                              <!-- 指定maven编译的jdk版本,如果不指定,maven3默认用jdk 1.5 maven2默认用jdk1.3 -->
                              <source>1.8</source> <!-- 源代码使用的JDK版本 -->
                              <target>1.8</target> <!-- 需要生成的目标class文件的编译版本 -->
                              <encoding>UTF-8</encoding><!-- 字符集编码 -->
                          </configuration>
                      </plugin>
           
                      <plugin>
                          <groupId>org.apache.maven.plugins</groupId>
                          <artifactId>maven-assembly-plugin</artifactId&androidgt;
                          <configuration>
                              <archive>
                                  <!-- 指定启动类 -->
                                  <manifest>
                                      <mainClass>com.cw.HelloStart</mainClass>
                                  </manifest>
                              </archive>
                              <!-- 描述后缀 -->
                              <descriptorRefs>
                                  <descriptorRef>jar-with-dependencies</descriptorRef>
                              </descriptorRefs>
                          </configuration>
                          <!-- 相当于在执行 package 打包时,在后面加上 assembly:single  -->
                          <executions>
                              <execution>
                                  <id>make-assembly</id>
                                  <phase>package</phase>
                                  <goals>
                                      <goal>single</goal>
                                  </goals>
                              </execution>
                          </executions>
                      </plugin>
                  </plugins>
              </build>

          效果

          解读maven项目的打包方式

          两者的区别

          test-jar-with-dependencies.jar

          解读maven项目的打包方式

          test.jar

          解读maven项目的打包方式

          明显可以看到test-jar-with-dependencies.jar才是我们需要的。

          maven-shade-plugin

          根据 Maven 的官方文档介绍,maven-shade-plugin 是一个强大的打包插件。它同样可以将项目的依赖以及项目的源码打包成一个可执行 Jar 包。

          依赖配置

              <build>
                  <!-- 项目最终打包成的名字 -->
                  <finalName>test</finalName>
                  <plugins>
                      <plugin>
                          <artifactId>maven-compiler-plugin</artifactId>
                          <version>3.8.1</version>
                          <configuration>
                              <!-- 指定maven编译的jdk版本,如果不指定,maven3默认用jdk 1.5 maven2默认用jdk1.3 -->
                              <source>1.8</source> <!-- 源代码使用的JDK版本 -->
                              <target>1.8</target> <!-- 需要生成的目标class文件的编译版本 -->
                              <encoding>UTF-8</encoding><!-- 字符集编码 -->
                          </configuration>
                      </plugin>
           
                      <plugin>
                          <groupId>org.apache.maven.plugins</groupId>
                          <artifactId>maven-shade-plugin</artifactId>
                          <version>3.2.4</version>
                          <executions>
                              <execution>
                                  <phase>package</phase>
                                  <goals>
                                      <goal>shade</goal>
                                  </goals>
                                  <configuration>
                                      <transformers>
                                          <!-- 指定启动类 -->
                                          <transformer
                                                  implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                              <mainClass>com.cw.HelloStart</mainClass>
                                          </transformer>
           
                                          <!-- 下面的配置仅针对存在同名资源文件的情况,如没有则不用配置-->
                                          <!-- 有些项目包可能会包含同文件名的资源文件(例如属性文件)-->
                                          <!-- 为避免覆盖,可以将它们的内容合并到一个文件中 -->
                                          <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>

          效果

          解读maven项目的打包方式

          两种第三方插件打包方式的总结

          使用第二种方式的 assembly 打包出来的 Jar 包多多少少有些问题,但是使用第三种方式打包出来的 Jar 包一般都是可用的。所以在将项目打包为大包时,还是推荐使用第三种打包的方式。

          如果是大数据项目中,我们日常使用比较多的是maven-assembly-plugin插件,例如:大数据项目中往往有很多shell脚本、SQL脚本、.properties.XML配置项等,采用assembly插件可以让输出的结构清晰而标准化。

          以上为个人经验,希望能给大家一个参考,也希望大家多多支持编程客栈(www.devze.com)。

          0

          精彩评论

          暂无评论...
          验证码 换一张
          取 消