[Apache Maven Shade Plugin] [example] [001] 官方例子：includes-excludes

链接地址：[Selecting Contents for Uber JAR](http://maven.apache.org/plugins/maven-shade-plugin/examples/includes-excludes.html)

apache网站在国内打开太慢了。因此我将这些有用的资源收集起来，保存在博客中！

Apache Maven Shade Plugin：是一个Maven打包的插件。其官网英文定义如下：This plugin provides the capability to package the artifact in an uber-jar, including its dependencies and to shade

001.

 <project>

   ...

   <build>

     <plugins>

       <plugin>

         <groupId>org.apache.maven.plugins</groupId>

         <artifactId>maven-shade-plugin</artifactId>

         <version>2.4.3</version>

         <executions>

           <execution>

             <phase>package</phase>

             <goals>

               <goal>shade</goal>

             </goals>

             <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>

           </execution>

         </executions>

       </plugin>

     </plugins>

   </build>

   ...

 </project>

002.

 <project>

   ...

   <build>

     <plugins>

       <plugin>

         <groupId>org.apache.maven.plugins</groupId>

         <artifactId>maven-shade-plugin</artifactId>

         <version>2.4.3</version>

         <executions>

           <execution>

             <phase>package</phase>

             <goals>

               <goal>shade</goal>

             </goals>

             <configuration>

               <filters>

                 <filter>

                   <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>

                 <filter>

                   <artifact>*:*</artifact>

                   <excludes>

                     <exclude>META-INF/*.SF</exclude>

                     <exclude>META-INF/*.DSA</exclude>

                     <exclude>META-INF/*.RSA</exclude>

                   </excludes>

                 </filter>

               </filters>

             </configuration>

           </execution>

         </executions>

       </plugin>

     </plugins>

   </build>

   ...

 </project>

003.

 <project>

   ...

   <build>

     <plugins>

       <plugin>

         <groupId>org.apache.maven.plugins</groupId>

         <artifactId>maven-shade-plugin</artifactId>

         <version>2.4.3</version>

         <executions>

           <execution>

             <phase>package</phase>

             <goals>

               <goal>shade</goal>

             </goals>

             <configuration>

               <minimizeJar>true</minimizeJar>

             </configuration>

           </execution>

         </executions>

       </plugin>

     </plugins>

   </build>

   ...

 </project>

004.

 <project>

   ...

   <build>

     <plugins>

       <plugin>

         <groupId>org.apache.maven.plugins</groupId>

         <artifactId>maven-shade-plugin</artifactId>

         <version>2.4.3</version>

         <executions>

           <execution>

             <phase>package</phase>

             <goals>

               <goal>shade</goal>

             </goals>

             <configuration>

               <minimizeJar>true</minimizeJar>

               <filters>

                 <filter>

                    <artifact>log4j:log4j</artifact>

                    <includes>

                        <include>**</include>

                    </includes>

                 </filter>

                 <filter>

                    <artifact>commons-logging:commons-logging</artifact>

                    <includes>

                        <include>**</include>

                    </includes>

                 </filter>

               </filters>

             </configuration>

           </execution>

         </executions>

       </plugin>

     </plugins>

   </build>

   ...

 </project>

(001)`Shade`官网上的介绍也不多。可能因为其相对比较简单吧。但是，我这个菜鸟仍然很头疼如何配置`Shade`。网上的资料比较少，估计也是认为比较简单吧，没人撰文详细介绍`Shade`。所以，官方提供的例子就成为最有价值的资料了。

(002)结合`Shade`源码，我开始踏上研究如何使用的`Shade`旅程。源码的获得比较简单，为了研究`Shade`可以将其添加到pom.xml的`dependencies`中。当然也可以去官网镜像下载。

(003)研究任何`Maven Plugin`之前，都应该先看看这篇插件的介绍 [Guide to Configuring Plug-ins](http://maven.apache.org/guides/mini/guide-configuring-plugins.html)，这会让你少走很多弯路（我不会告诉你我是掉坑里了爬起来才知道的）。

(003001)在这篇官方文档里，我首次看到了`Mojo`，这是Maven Plugin使用的一个IOC框架。（当下我并没有去研究Mojo所以知道的有限也许未来会去研究下。有兴趣的朋友可以去搜索下。）

(003002)`Mojo`中的字段是和plugin中的配置对应的，如果对例子中的配置很疑惑，就可以翻开源码中的`Mojo`顺藤摸瓜，找到它们的原理。`Shade`中的`Mojo`就是`ShadeMojo.java`了。

(004)end.