51Testing软件测试论坛

标题: Maven和Maven插件 [打印本页]

作者: 悠悠小仙仙    时间: 2019-6-19 16:47
标题: Maven和Maven插件
Maven和Maven插件人生是一张茶几,上面摆满了杯具,请让我们的杯具与众不同。
这是我这篇博文的一个主题。

我们知道maven是一个项目管理的工具,他把项目抽象为一个个的生命周期和阶段。我们先来介绍一下maven最重要的几个概念:
形象的来一个比喻,如同下面一张图所示:
[attach]125291[/attach]


一个项目的生命周期如同一个人的生命周期(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    时间: 2020-12-30 15:12
支持分享




欢迎光临 51Testing软件测试论坛 (http://bbs.51testing.com/) Powered by Discuz! X3.2