悠悠小仙仙 发表于 2019-6-19 16:47:31

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插件工程。


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模板来建立插件项目。
/**@author xingming.zhaoxm   
*   @goal sayHello   
*/   
public class HelloWorldMojo extends AbstractMojo{   
@Override      
public void execute() throws MojoExecutionException, MojoFailureException {   
      getLog().info("Hello World!");      
} }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配置文件中,可以找到这样一个配置项:
<pluginGroups>
    <pluginGroup>*</pluginGroup>
</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。如下

/**   
* @author xingming.zhaoxm   
* @goal sayHello   
*/   
public class HelloWorldMojo extends AbstractMojo{      
/**      
* @parameter default-value="Somebody" expression="${username}      
*/
private String userName;      
@Override      
public void execute() throws MojoExecutionException, MojoFailureException {   
      getLog().info("Hello World!"+userName);      
} }
在install一把,然后运行
mvn greeting:sayHello -Dusername=白痴看看是否已经ok了。


上面的插件都在命令行模式下运行,下面我再把项目中运行的插件方式和方法做一个简要的梳理。这些类似的插件有很多,比如jetty插件,各种reporting插件等等。
我们先创建一个测试工程,用于应用和测试我们写的HelloWrold插件。
mvn archetype:create -DgroupId=com.alibaba -DartifactId=test然后在pom文件中加入插件的依赖,如下
<build>         
<plugins>            
<plugin>               
      <groupId>com.alibaba.maven.plugins</groupId>         
      <artifactId>greeting-maven-plugin</artifactId>         
      <version>1.0-SNAPSHOT</version>         
      <executions>            
         <execution>               
          <phase>initialize</phase>            
            <goals>               
            <goal>sayHello</goal>            
         </goals>            
         </execution>         
       </executions>      
   </plugin>      
   </plugins>   
</build>
对该项目进行编译,mvn install 后,我们会发现在项目的initialize阶段,便会打印出hello world!的信息。插件绑定到了特定的phase,如果我们不通过编译该测试工程运行插件,我们依然通过命令行,比如 mvn greeting:sayHello,我们会发现,在绑定phase阶段的先前阶段会先顺序执行后,才开始运行插件。
插件配置中也可以配置参数,优先级以配置项为先,而命令行参数为后。如我们可以这样配置插件参数:
<build>      
   <plugins>         
    <plugin>         
       <groupId>com.alibaba.maven.plugins</groupId>   
       <artifactId>greeting-maven-plugin</artifactId>         
       <version>1.0-SNAPSHOT</version>
       <configuration>   
            <userName>阿娇</userName>
       </configuration>         
      <executions>            
      <execution>            
            <phase>initialize</phase>            
         <goals>               
            <goal>sayHello</goal>            
         </goals>            
         </execution>         
      </executions>         
    </plugin>      
   </plugins>   
</build>











Miss_love 发表于 2020-12-30 15:12:55

支持分享
页: [1]
查看完整版本: Maven和Maven插件