Spring cloud的Maven插件（一）：repackage目标

简介

　　Spring Boot Maven Plugin插件提供spring boot在maven中的支持。允许你打包可运行的jar包或war包。

　　插件提供了几个maven目标和Spring Boot 应用一起工作。总的有：

spring-boot:repackage 请阅读：Spring cloud的Maven插件（一）：repackage目标
spring-boot:run 请阅读：Spring cloud的Maven插件（二）：run目标
spring-boot:start and spring-boot:stop
spring-boot:build-info

　　repackage：创建一个自动可执行的jar或war文件。它可以替换常规的artifact，或者用一个单独的classifier附属在maven构建的生命周期中。

　　下面我们详细看下repackage这个目标。

一、简单引用

　　用了重新打包应用程序，我们需要在pom.xml文件中加一个简单的引用到Spring Boot Maven Plugin插件中，代码如下：repaceage 最简单的结构

 <build>

   ...

   <plugins>

     ...

     <plugin>

       <groupId>org.springframework.boot</groupId>

       <artifactId>spring-boot-maven-plugin</artifactId>

       <version>1.5.7.RELEASE</version>

       <executions>

         <execution>

           <goals>

             <goal>repackage</goal>

           </goals>

         </execution>

       </executions>

     </plugin>

     ...

   </plugins>

   ...

 </build>

repaceage 最简单的结构

二、剔除不需要的依赖

　　这个例子重新打包了一个jar包或war包，这个jar包或war包被构建于maven生命周期的package阶段，包括定义在工程中的任何依赖（包括scope为provided）。如果有一些依赖模块需要被排除掉，可以使用一个exclude的选项。

　　默认情况下，repackage和run这两个maven目标会包括定义在工程中的任何依赖。一些依赖被要求从可执行jar包中排除。下面有三种方式可以在包运行时排除依赖模块。

　　方式1：:排除一个具体的maven 模块，通过唯一的groupId和artifactId组合来实现。（如果有必要，可以加入classifier来唯一确认。）

 <project>

   ...

   <build>

     ...

     <plugins>

       ...

       <plugin>

         <groupId>org.springframework.boot</groupId>

         <artifactId>spring-boot-maven-plugin</artifactId>

         <version>1.5.6.RELEASE</version>

         <configuration>

           <excludes>

             <exclude>

               <groupId>com.foo</groupId>

               <artifactId>bar</artifactId>

             </exclude>

           </excludes>

         </configuration>

         ...

       </plugin>

       ...

     </plugins>

     ...

   </build>

   ...

 </project>

排除一个具体的maven模块

　　方式2：排除和“指定的artifactId”相符的所有maven模块。

 <project>

   ...

   <build>

     ...

     <plugins>

       ...

       <plugin>

         <groupId>org.springframework.boot</groupId>

         <artifactId>spring-boot-maven-plugin</artifactId>

         <version>1.5.6.RELEASE</version>

         <configuration>

           <excludeArtifactIds>my-lib,another-lib</excludeArtifactIds>

         </configuration>

         ...

       </plugin>

       ...

     </plugins>

     ...

   </build>

   ...

 </project>

排除和指定的artifactId项目的所有maven模块

　　方式3：排除属于“指定的groupId”的所有maven模块。

 <project>

   ...

   <build>

     ...

     <plugins>

       ...

       <plugin>

         <groupId>org.springframework.boot</groupId>

         <artifactId>spring-boot-maven-plugin</artifactId>

         <version>1.5.6.RELEASE</version>

         <configuration>

           <excludeGroupIds>com.foo</excludeGroupIds>

         </configuration>

         ...

       </plugin>

       ...

     </plugins>

     ...

   </build>

   ...

 </project>

排除属于指定的groupId的所有maven模块

三、重写manifest　

　　这个插件还可以重写项目的manifest （可运行jar包的MANIFEST.MF），特别是管理Main-Class和Start-Class启动类。如果默认的配置不能满足需求，我们可以在这里做配置。通过插件的layout属性可以确实地控制Main-Class。

 <build>

   ...

   <plugins>

     ...

     <plugin>

       <groupId>org.springframework.boot</groupId>

       <artifactId>spring-boot-maven-plugin</artifactId>

       <version>1.5.7.RELEASE</version>

       <configuration>

         <mainClass>${start-class}</mainClass>

         <layout>ZIP</layout>

       </configuration>

       <executions>

         <execution>

           <goals>

             <goal>repackage</goal>

           </goals>

         </execution>

       </executions>

     </plugin>

     ...

   </plugins>

   ...

 </build>

repackage mainClass

　　执行打包命令：mvn package spring-boot:repackage。注意：这里不能写成mvn spring-boot:repackage。否则会报Source must refer to an existing file异常。

　　layout属性默认根据archive type（jar or war）而定。总的有5中类型：

JAR：常规的可执行jar包的布局。
WAR：可执行war包的布局。
ZIP（和DIR一样）：和使用PropertiesLauncher的jar包布局一样。
MODULE:包括依赖包（排除scope为provided的依赖包）和项目资源
NONE:包括所有的依赖包和项目资源。

四、利用classifier分离代码包和依赖包

　　当自己写项目需要发布出去给别人依赖时，就只需要自己写的代码打包，依赖的包不能打进来。否则最后别人在用你提供的包时，就会出现重复包，导致最后打包时包会非常巨大。

　　在这个Spring Boot Maven Plugin这个插件下，我们只需要提供classifier即可实现这个功能。具体如下：

 <project>

   ...

   <build>

     ...

     <plugins>

       ...

       <plugin>

         <groupId>org.springframework.boot</groupId>

         <artifactId>spring-boot-maven-plugin</artifactId>

         <version>1.5.7.RELEASE</version>

         <executions>

           <execution>

             <goals>

               <goal>repackage</goal>

             </goals>

             <configuration>

               <classifier>exec</classifier>

             </configuration>

           </execution>

         </executions>

         ...

       </plugin>

       ...

     </plugins>

     ...

   </build>

   ...

 </project>

repackage classifier

五、打包时排除resources下的资源文件

 <build>

   ...

     <resources>

         <resource>

             <directory>src/main/resources</directory>

             <excludes>

                 <exclude>**/*.properties</exclude>

                 <exclude>**/*.xml</exclude>

                 <exclude>**/*.yml</exclude>

             </excludes>

         </resource>

     </resources>

     <plugins>

       ...

         <plugin>

             <groupId>org.springframework.boot</groupId>

             <artifactId>spring-boot-maven-plugin</artifactId>

             <executions>

                 <execution>

                     <goals>

                         <goal>repackage</goal>

                     </goals>

                 </execution>

             </executions>

         </plugin>

       ...

     </plugins>

   ...

 </build>

排除resources下的资源文件

喜欢请微信扫描下面二维码，关注我公众号--“精修Java”，做一些实战项目中的问题和解决方案分享。

巴特西