java example cat_java maven hello example

Maven插件开发

From:

Maven 插件开发—-让maven使用更加灵活

对

于习惯于使用maven构建、管理项目的人来说，maven就是项目开发、测试、部署的一把利器：对类库的集中管理；依赖传递、继承、重用性高；对整个项

目开发生命周期的完整支持，从头到尾只需要几个简单的命令就可以快速地遍历整个开发周期，减轻了配置管理的工作量。这些优秀的功能都是通过maven插件

库里提供的丰富插件来完成的。因此，掌握maven插件开发、在实际工作中根据自己的需要开发适合自己需求maven插件，是很有必要的。

这篇文章先从动手实践开始，迅速开发出自己的一个maven插件，然后根据主要构建过程和配置予以简单说明。

一，快速开发你的第一个插件

1，创建一个maven-plugin目录，并通过CMD程序从后台进入此目录。

2，运行命令：mvn archetype:create -DgroupId=com.taobao.maven -DartifactId=maven-hello-plugin -DarchetypeArtifactId=maven-archetype-mojo

3，进入maven-hello-plugin目录，运行命令：mvn eclipse:eclipse构建eclipse工程。

4，通过eclipse import工程，删除包下面自动生成的java文件，新建GreetingMojo.java和GoodByeMojo.java，分别对应打招呼、再见两个动作。

GreetingMojo.java的内容如下：package com.taobao.maven;

import org.apache.maven.plugin.AbstractMojo;

import org.apache.maven.plugin.MojoExecutionException;

/**

* @goal greeting

public class GreetingMojo extends AbstractMojo {

/**

* @parameter expression=”${greeting.words}” default-value=”Hello to you!”

private String words ;

public void execute() throws MojoExecutionException {

getLog().info(words);

}

GoodByeMojo.java的内容如下：package com.taobao.maven;

import org.apache.maven.plugin.AbstractMojo;

import org.apache.maven.plugin.MojoExecutionException;

import org.apache.maven.plugin.MojoFailureException;

/**

* @goal goodBye

public class GoodByeMojo extends AbstractMojo {

/**

* @parameter expression=”${goodBye.words}” default-value=”goodBye to you!”

private String words;

public void execute() throws MojoExecutionException, MojoFailureException {

getLog().info(words);

}

pom.xml中的依赖为：

org.apache.mavengroupId>

maven-plugin-apiartifactId>

2.0version>

dependency>

com.alibaba.externalgroupId>

test.junitartifactId>

4.4version>

testscope>

dependency>

5，文件编写完成后回到cmd命令行，在项目的pom文件目录处运行install命令将插件安装到本地repository：mvn clean install

6，安装成功后继续运行如下命令查看插件的运行情况：

运行：mvn com.taobao.maven:maven-hello-plugin:1.0-SNAPSHOT:greeting

，可以看到控制台看到输出：“Hello to you!”；这个输出是插件的默认参数：default-value=”Hello to you!”

运行mvn com.taobao.maven:maven-hello-plugin:1.0-SNAPSHOT:goodBye

，可以在控制台看到输出：“goodBye to you!”；这个输出是插件的默认参数：default-value=”goodBye to you!”

运行：mvn com.taobao.maven:maven-hello-plugin:1.0-SNAPSHOT:greeting -Dgreeting.words=”welcome!”

可以在控制台看到输出：“welcome!”；这个在命令中明确指定插件的参数，因此输出的是指定的参数“welcome!”。

运行mvn com.taobao.maven:maven-hello-plugin:1.0-SNAPSHOT:goodBye -DgoodBye.words=”see you!”

可以在控制台看到输出：“see you!”；这个在命令中明确指定插件的参数，因此输出的是指定的参数“see you!”。

7，至此，一个“见面寒暄”的简单maven插件基本完成。

二，插件开发过程的相关说明

1，MOJO

Maven 通过插件动作完成大多数构建任务。可以把 Maven 引擎认为是插件动作的协调器。插件中的每个任务goal称作一个 Mojo(Maven plain Old Java Object)。项目中每一个Mojo都要实现org.apache.maven.plugin.Mojo接口，上面的插件示例的Mojo通过扩展org.apache.maven.plugin.AbstractMojo类实现了该接口。Mojo提供过了如下的方法：void setLog( org.apache.maven.monitor.logging.Log log )

每一个Mojo实现都必须提供一种方法让插件能够和某个特定目标的过程相交流。该目标成功了么？或者，是否在运行目标的时候遇到了问题？当Maven加载并运行Mojo的时候，它会调用setLog()方法，为Mojo实例提供正确的日志目标，以让你在自定义插件中使用。protected Log getLog()

Maven会在Mojo运行之前调用setLog()方法，然后你的Mojo就可以通过调用getLog()获得日志对象。Mojo应该去调用这个Log对象的方法，而不是直接将输出打印到标准输出或者控制台。void execute() throws org.apache.maven.plugin.MojoExecutionException

轮到运行目标的时候，Maven就会调用该方法。

Mojo

接口只关心两件事情：目标运行结果的日志记录，以及运行一个目标。当编写自定义插件的时候，需要扩展AbstractMojo。AbstractMojo

处理setLog()和getLog()的实现，并包含一个抽象的execute()方法。在扩展AbstractMojo的时候，你所需要做的只是实现

execute()方法。

2，Phase

Maven 对构建生命周期的固定理解包含了许多不同的阶段，如下表：

...省略

3，插件组成

每一个mojo都由一些注解annotation来描述，这些注解是在java类的上面标注。常用的几个注解如下：

execute：注解形式：a), @execute phase=”” lifecycle=””;

b), @execute phase=””