如何利用Maven將代碼打包成第三方公共Jar包？

作者：鴨血粉絲Tang 2022-10-24 07:32:20

shade可以將多個(gè)相同的配置文件追加合并，比如，多個(gè)子項(xiàng)目下有相同的配置文件，shade在打包的時(shí)候，會(huì)將相同的配置文件合并。

一、摘要

在項(xiàng)目開發(fā)過(guò)程中，我們經(jīng)常需要將一些公共方法提取出來(lái)，然后單獨(dú)封裝成一個(gè)第三方公共jar包，采用普通的方式打包后的jar，依賴的工程執(zhí)行編譯時(shí)，卻提示找不到對(duì)應(yīng)的依賴包，那么如何將工程打包為可執(zhí)行jar包呢？

下面向大家介紹三種通過(guò)maven將工程打包成可執(zhí)行的打包方式。

二、方法實(shí)踐

2.1、assembly插件

2.1.1、pom.xml的相關(guān)配置文件如下

<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.java</groupId>
  <artifactId>example-frame-fatJar</artifactId>
  <version>1.0.0</version>

  .....
  <build>
    <finalName>sso-api</finalName>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.2</version>
        <configuration>
          <source>1.7</source>
          <target>1.7</target>
          <encoding>UTF-8</encoding>
        </configuration>
      </plugin>
      <!-- maven-assembly-plugin -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>2.6</version>
        <configuration>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
          <encoding>UTF-8</encoding>
        </configuration>
        <executions>
          <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

2.1.2、運(yùn)行如下命令，進(jìn)行打包

mvn clean package

會(huì)在target文件夾里生成一個(gè)jar-with-dependencies的jar是可執(zhí)行的。

2.1.3、驗(yàn)證jar是否可執(zhí)行

在帶有jar-with-dependencies的jar文件下，打開終端，輸入如下命令

#驗(yàn)證jar是否可執(zhí)行，如果沒(méi)有報(bào)錯(cuò)，說(shuō)明沒(méi)有問(wèn)題
java -jar xxx-jar-with-dependencies.jar

2.2、shade插件

2.2.1、pom.xml的相關(guān)配置文件如下

<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.java</groupId>
  <artifactId>example-frame-fatJar</artifactId>
  <version>1.0.0</version>

  ......
  <build>
    <finalName>sso-api</finalName>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.2</version>
        <configuration>
          <source>1.7</source>
          <target>1.7</target>
          <encoding>UTF-8</encoding>
        </configuration>
      </plugin>
      <!-- maven-shade-plugin，不同的是shade可以將多個(gè)相同的配置文件追加合并 -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>2.4.1</version>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>shade</goal>
            </goals>
            <configuration>
              <transformers>
                <transformer
                  implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                  <mainClass>com.xxg.Main</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>
</project>

2.2.2、運(yùn)行如下命令，進(jìn)行打包

mvn clean package

發(fā)現(xiàn)生成了2個(gè)jar包，一個(gè)為：original-XXX.jar，另一個(gè)為：XXX.jar，其中original...jar里只包含了工程自己的class文件，而另外的一個(gè)jar包則包含了工程本身以及所有依賴的jar包的class文件。我們只需要使用第二個(gè)jar包就可以了。

2.2.3、驗(yàn)證jar是否可執(zhí)行

在XXX.jar文件下，打開終端，輸入如下命令

#驗(yàn)證jar是否可執(zhí)行，如果沒(méi)有報(bào)錯(cuò)，說(shuō)明沒(méi)有問(wèn)題
java -jar XXX.jar

不同點(diǎn)：shade可以將多個(gè)相同的配置文件追加合并，比如，多個(gè)子項(xiàng)目下有相同的配置文件，shade在打包的時(shí)候，會(huì)將相同的配置文件合并。

2.3、Fatjar打包工具(eclipse插件)

2.3.1、eclipse在線安裝插件

1、打開eclipse，打開菜單help > Install New Sofware > Add...

name：FatJar

URL：http://kurucz-grafika.de/fatjar

根據(jù)提示下載安裝并重啟eclipse！

2.3.2、FatJar使用

在使用Eclipse進(jìn)行導(dǎo)出時(shí)，點(diǎn)擊項(xiàng)目右鍵，在彈出的右鍵菜單中選擇Build Fat Jar, 打開配置Fat Jar彈出框；或者，項(xiàng)目右鍵，點(diǎn)擊Export，然后在打開的Export選擇框中選擇Other下面的Fat Jar Exporter, 選擇需要導(dǎo)出的項(xiàng)目，點(diǎn)擊下一步打開配置Fat Jar彈出框。

2.3.3、驗(yàn)證jar是否可執(zhí)行