Apache maven shade plugin使用说明

最近在解决java jar包冲突的时候用到了shade插件，于是从官网仔细看了下shade的详细使用，翻译总结如下，希望能用得到。

---

introduction

Apache maven shade plugin提供把工程的artifact及其依赖打包到一个uber-jar中并能隐藏起来（比如重命名），shade插件仅仅有一个功能就是创建一个shaded包。
那什么是uber-jar呢，uber在德语中是above或over的意思，在这里表示是从单一的jar提升到“over-jar”，即把所有的依赖都定义到一个jar文件里。
好了，现在我们知道shade插件的基本作用了，现在从官网给出的几个例子看看实际的应用。

为uber-jar选择内容

这是官网直译的标题，用我们容易理解的就是通过shade插件我们可以为生成的那个jar包选择包含哪些依赖以及排除哪些依赖。
1. 支持两种操作include和exclude
2. 配置格式：groupId:artifactId[[:type]:classifier]，至少包含groupid和artifactid，type和类名可选
3. 支持’*’ 和 ‘?’执行通配符匹配
比如，一个示例如下：

project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.pluginsgroupId>
        <artifactId>maven-shade-pluginartifactId>
        <version>3.0.0version>
        <executions>
          <execution>
            <phase>packagephase>
            <goals>
              <goal>shadegoal>
            goals>
            <configuration>
              <artifactSet>
                <excludes>
                  <exclude>classworlds:classworldsexclude>
                  <exclude>junit:junitexclude>
                  <exclude>jmock:*exclude>
                  <exclude>*:xml-apisexclude>
                  <exclude>org.apache.maven:lib:testsexclude>
                  <exclude>log4j:log4j:jar:exclude>
                excludes>
              artifactSet>
            configuration>
          execution>
        executions>
      plugin>
    plugins>
  build>
  ...
project>

类重定位

官网是“Relocating Classes”，如果一个uber-jar会被其他项目引用，uber-jar中依赖的类可能会导致类定位冲突（由于不同版本的jar包引起），我们可以通过shade插件来将被隐藏的类重定位以使该类只在该uber-jar中使用，这种方式也经常被用来解决jar包冲突问题。
示例如下：

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.pluginsgroupId>
        <artifactId>maven-shade-pluginartifactId>
        <version>3.0.0version>
        <executions>
          <execution>
            <phase>packagephase>
            <goals>
              <goal>shadegoal>
            goals>
            <configuration>
              <relocations>
                <relocation>
                  <pattern>org.codehaus.plexus.utilpattern>
                  <shadedPattern>org.shaded.plexus.utilshadedPattern>
                  <excludes>
                    <exclude>org.codehaus.plexus.util.xml.Xpp3Domexclude>
                    <exclude>org.codehaus.plexus.util.xml.pull.*exclude>
                  excludes>
                relocation>
              relocations>
            configuration>
          execution>
        executions>
      plugin>
    plugins>
  build>
  ...
project>

上述例子是让org.codehaus.plexus.util包和它的子包移动到 org.shaded.plexus.util包中，而类Xpp3Dom和其他的一些则保留在原来的package中。

Shaded Artifact附加名字

默认情况下，当执行installed/deployed时候，会默认生成两个jar包，一个以-shaded结尾，这个我们可以配置更改，示例如下：

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.pluginsgroupId>
        <artifactId>maven-shade-pluginartifactId>
        <version>3.0.0version>
        <executions>
          <execution>
            <phase>packagephase>
            <goals>
              <goal>shadegoal>
            goals>
            <configuration>
              <shadedArtifactAttached>trueshadedArtifactAttached>
              <shadedClassifierName>myNameshadedClassifierName> 
            configuration>
          execution>
        executions>
      plugin>
    plugins>
  build>
  ...
project>

则会生成以-myName结尾的jar包。

可执行jar包

要创建一个可执行uber-jar包，也可以将入口添加进来，示例如下：

<project>
   <groupId>shade.testgroupId>
    <artifactId>shade.testartifactId>
    <version>1.0-SNAPSHOTversion>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.pluginsgroupId>
        <artifactId>maven-shade-pluginartifactId>
        <version>3.0.0version>
        <executions>
          <execution>
            <phase>packagephase>
            <goals>
              <goal>shadegoal>
            goals>
            <configuration>
              <transformers>
                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                  <mainClass>MainmainClass>
                transformer>
              transformers>
            configuration>
          execution>
        executions>
      plugin>
    plugins>
  build>
  ...
project>

假设入口函数为：

public class Main {
    public static void main(String[] args) {
        System.out.println("shade Executable test");
    }
}

执行mvn package，生成两个jar文件，一个是原始的original-shade.test-1.0-SNAPSHOT.jar，一个是可执行的shade.test-1.0-SNAPSHOT.jar。
执行java -jar shade.test-1.0-SNAPSHOT.jar，效果如下：

以上，是maven shade插件的一些用法。

---

【参考资料】http://stackoverflow.com/questions/11947037/what-is-an-uber-jar
【参考资料】官网