Maven和Maven插件

悠悠小仙仙

Maven和Maven插件人生是一张茶几，上面摆满了杯具，请让我们的杯具与众不同。
这是我这篇博文的一个主题。

我们知道maven是一个项目管理的工具，他把项目抽象为一个个的生命周期和阶段。我们先来介绍一下maven最重要的几个概念：

• 
  1、lifecycle 生命周期，一个项目在maven中有三个生命周期，分别为default,clean,site。default主要是编译和部署生命周期，clean是清理生命周期，site是生成报表、工程文档等生命周期。
  2、phase 生命周期中阶段。如default的生命周期中拥有validate、initialize、compile、test-compile、prepare-package、package、install、deploy等等的阶段。阶段是顺序执行的。
  3、goal 阶段中的目标。每一个阶段中，蕴含着一个或多个目标。
  4、mojo 执行目标的具体代类
  

形象的来一个比喻，如同下面一张图所示：



一个项目的生命周期如同一个人的生命周期(lifecycle)，分为多个阶段(phase)，如3岁前是幼儿期，4-22岁是幼年期，23-53是中轻年期，51-70是老年期。而每个阶段(phase)我们又会有不一样的目标(goal)，比如幼儿期，我们的目标(goal)是喝奶，幼年期的目标(goal)是读书、长大，中年期的目标是结婚生子等等等等。这些组成我们人生的杯具。但是我们作为一个杯具的执行者(mojo)，还得一步一步的去走我们的各个阶段，实现我们的各个目标。

项目都有标准的生命周期，编译前检查、资源生成、编译、部署、发布等等。但是每个项目又是如此不同，我们怎样改变我们的项目，使得这一个个的杯具有所不同呢？我们可以使用maven的插件和编写maven的插件来实现。比如我们想在编译前，去读取一台网络设备的配置；再或则需要收集其他资源等等。maven插件让我们项目丰富多彩，跟我们人生的杯具一样，请让我们的杯具与众不同。

讲解了maven的一些概念以后，我们进入maven插件的编写讲述上。

maven插件，也是以mojo来体现的，写插件就是写mojo。那为什么maven的标准mojo成为标准的生命周期中的goal实现，而我们的插件就跟二奶一样，不被承认，只能叫做插件呢。

比如我们在运行：maven install的时候，到底运行了什么？我们让maven执行默认生命周期中的一个阶段(phase)，这个阶段叫install，而这个阶段默认绑定了一个目标(goal)，目标的名称也叫install。也就是说我们让maven唤醒项目的一次install目标。如执行maven install:install。maven会根据默认的生命周期阶段，先执行先前的阶段(validate,initialize...)，然后执行编译和安装。插件的运行方式类似，如maven eclipse:eclipse 我们让maven唤起运行eclipse的插件，生成eclipse的项目文件。他们运行方式如此的相似，是因为他们本来就是同样的东西--mojo。


了解了我们的maven部分概念和插件的定位之后，我们来写我们的第一个maven插件。插件之hello world。

所有的mojo都应该继承自org.apache.maven.plugin.AbstractMojo，我们来建立我们的maven插件工程。

1. mvn archetype:create -DgroupId=com.alibaba.maven.plugins -DartifactId=greeting-maven-plugin -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-mojo  

复制代码

跟普通Maven的项目一样，自己定义groupId和artifactId。我们这里分别定义groupId为com.alibaba.maven.plugins和greeting-maven-plugin。
archetypeGroupId和archetypeArtifactId用来定位用哪个maven的工程模板来建立项目。当然我们使用的是maven-archetype-mojo模板来建立插件项目。

1. /**  @author xingming.zhaoxm   
   
2. *   @goal sayHello   
   
3. */   
   
4. public class HelloWorldMojo extends AbstractMojo{   
   
5. @Override      
   
6. public void execute() throws MojoExecutionException, MojoFailureException {   
   
7.       getLog().info("Hello World!");      
   
8. } }  

复制代码

Ok,如上所示我们复写了execute方法，最重要@goal的一个annotation，它定义了这个mojo跟goal一一对应的关系。现在我们运行命令mvn install 把该插件先发布到本地库。之后我们便可以执行我们的插件了。

插件的运行方式为：mvn groupID:artifactID:version:goal
按照我们的项目，那么我们运行插件应该：mvn com.alibaba.maven.plugins:greeting-maven-plugin:1.0-SNAPSHOT:sayHello

看看，我们是不是已经在控制台看到我们打出的"Hello World"文字了。想想，为什么mvn eclipse:eclipse的插件运行方式可以这么简单。


怎么减少输入呢？

首先，我们在maven的setting.xml配置文件中，可以找到这样一个配置项：

1. <pluginGroups>  
   
2.     <pluginGroup>*</pluginGroup>  
   
3.   </pluginGroups>  

复制代码

如果这里配置上我们的groupID，如我们的com.alibaba.maven.plugins，那么groupId的输入便可省略了。
另外，我们的项目名称DartifactId如果以${name}-maven-plugin或以maven-${name}-plugin的格式命名，我们便能省去-maven-plugin等信息。
version本来可以省略，maven会找到最新的版本来执行。
那么省略后的执行命令就可以这样写了：mvn greeting:sayHello
Ok，那么我要运行插件时输入参数，该怎么处理呢？如同 mvn install -Dmaven.test.skip=true。我们重写我们的mojo，加入@parameter的annotation。如下

1. /**   
   
2. * @author xingming.zhaoxm   
   
3. * @goal sayHello   
   
4. */   
   
5. public class HelloWorldMojo extends AbstractMojo{      
   
6. /**      
   
7. * @parameter default-value="Somebody" expression="${username}      
   
8. */  
   
9. private String userName;      
   
10. @Override      
    
11. public void execute() throws MojoExecutionException, MojoFailureException {   
    
12.         getLog().info("Hello World!"+userName);      
    
13. } }  
    

复制代码

在install一把，然后运行

1. mvn greeting:sayHello -Dusername=白痴  

复制代码

看看是否已经ok了。


上面的插件都在命令行模式下运行，下面我再把项目中运行的插件方式和方法做一个简要的梳理。这些类似的插件有很多，比如jetty插件，各种reporting插件等等。
我们先创建一个测试工程，用于应用和测试我们写的HelloWrold插件。

1. mvn archetype:create -DgroupId=com.alibaba -DartifactId=test  

复制代码

然后在pom文件中加入插件的依赖，如下

1. <build>         
   
2. <plugins>            
   
3.   <plugin>                 
   
4.       <groupId>com.alibaba.maven.plugins</groupId>           
   
5.       <artifactId>greeting-maven-plugin</artifactId>           
   
6.       <version>1.0-SNAPSHOT</version>         
   
7.         <executions>            
   
8.          <execution>               
   
9.           <phase>initialize</phase>            
   
10.             <goals>                 
    
11.             <goal>sayHello</goal>              
    
12.            </goals>            
    
13.          </execution>         
    
14.        </executions>        
    
15.      </plugin>      
    
16.    </plugins>   
    
17. </build>  

复制代码

对该项目进行编译，mvn install 后，我们会发现在项目的initialize阶段，便会打印出hello world!的信息。插件绑定到了特定的phase，如果我们不通过编译该测试工程运行插件，我们依然通过命令行，比如 mvn greeting:sayHello，我们会发现，在绑定phase阶段的先前阶段会先顺序执行后，才开始运行插件。
插件配置中也可以配置参数，优先级以配置项为先，而命令行参数为后。如我们可以这样配置插件参数：

1. <build>      
   
2.    <plugins>         
   
3.     <plugin>         
   
4.        <groupId>com.alibaba.maven.plugins</groupId>   
   
5.        <artifactId>greeting-maven-plugin</artifactId>         
   
6.        <version>1.0-SNAPSHOT</version>  
   
7.        <configuration>   
   
8.             <userName>阿娇</userName>  
   
9.        </configuration>           
   
10.       <executions>            
    
11.         <execution>            
    
12.             <phase>initialize</phase>              
    
13.            <goals>                 
    
14.             <goal>sayHello</goal>              
    
15.            </goals>            
    
16.          </execution>           
    
17.       </executions>         
    
18.     </plugin>      
    
19.    </plugins>   
    
20. </build>  
    

复制代码

Miss_love

支持分享