原文:http://qa.taobao.com/?p=4964
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);
}
}
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 对构建生命周期的固定理解包含了许多不同的阶段,如下表:
validate |
验证 |
确保当前配置和POM的内容是有效的。这包含对pom文件树的验证。 |
initialize |
初始化 |
在执行构建生命周期的主任务之前可以进行初始化。 |
generate-sources |
生成源码 |
代码生成器可以开始生成在以后阶段中处理或编译的源代码。 |
process-sources |
处理源码 |
提供解析、修改和转换源码。常规源码和生成的源码都可以在这里处理。 |
generate-resources |
生成资源 |
可以生成非源码资源。通常包括元数据文件和配置文件。 |
process-resources |
处理资源 |
处理非源码资源。修改、转换和重定位资源都能在这阶段发生。 |
compile |
编译 |
编译源码。编译过的类被放到目标目录树中。 |
process-classes |
处理类 |
处理类文件转换和增强步骤。字节码交织器和常用工具常在这一阶段操作。 |
generate-test-sources |
生成测试源码 |
mojo可以生成要操作的单元测试代码。 |
process-test-sources |
处理测试源码 |
在编译前对测试源码执行任何必要的处理。在这一阶段,可以修改、转换或复制源代码。 |
generate-test-resources生成测试资源 |
允许生成与测试相关的(非源码)资源。 |
|
process-test-resources处理测试资源 |
可以处理、转换和重新定位与测试相关的资源。 |
|
test-compile |
测试编译 |
编译单元测试的源码。 |
test |
测试 |
运行编译过的单元测试并累计结果。 |
package |
打包 |
将可执行的二进制文件打包到一个分布式归档文件中,如 |
pre-integration-test |
前集成测试、准备集成测试。这种情况下的集成测试是指在一个受到一定控制的模拟的真实部署环境中测试代码。这一步能将归档文件部署到一个服务器上执行。 |
|
integration-test |
集成测试 |
执行真正的集成测试。 |
post-integration-test |
后集成测试、解除集成测试准备。这一步涉及测试环境重置或重新初始化。 |
|
verify |
检验 |
检验可部署归档的有效性和完整性。过了这个阶段,将安装该归档。 |
install |
安装 |
将该归档添加到本地Maven目录。这一步让其他可能依赖该归档的模块可以使用它。 |
deploy |
部署 |
将该归档添加到远程Maven目录。这一步让这个工件能为更多的人所用。 |
3,插件组成
每一个mojo都由一些注解annotation来描述,这些注解是在java类的上面标注。常用的几个注解如下:
execute:注解形式:
a), @execute phase=”<phaseName>” lifecycle=”<lifecycleId>”;
b), @execute phase=”<phaseName>”
c), @execute goal=”<goalName>”
当这个目标goal被调用时,它会先调用一个平行的生命周期,在制定的阶段结束。如果插件没有被指定阶段,这一目标将会单独执行。
goal:注解形式:@goal <goalName>
用户在命令行下直接调用插件的目标goal,或者在项目的pom文件中通过配置调用这个goal。
phase:注解形式:@phase <phaseName>
绑定这个mojo到标准构建生命周期里对应的阶段。
对于一个mojo里的变量参数,也有一些常用的注解:
configuration:注解形式:
@parameter expression=”${aSystemProperty}” default-value=”${anExpression}”
对参数指定一个计算表达式、在mojo构建时将计算结果注入到此变量中,同时也可以给定一个默认值。这个参数值也可以在pom文件中予以配置。
三,在其他工程中使用此插件
伴随插件开发完成,在被其他项目使用时有比较多的、灵活的配置,接下来也通过一个示例来使用这个插件。
1,回到maven-plugin目录,创建插件测试工程:
mvn archetype:create -DgroupId=com.taobao.maven -DartifactId=plugin-test -Dpackaging=jar
2,在测试工程的pom文件中加入插件依赖:
<build>
<plugins>
<plugin>
<groupId>com.taobao.maven</groupId>
<artifactId>maven-hello-plugin</artifactId>
<version>1.0-SNAPSHOT</version>
</plugin>
</plugins>
</build>
3,在上述配置后可以使用这个插件了,但是这个插件在开发的时候并没有定义插件运行的生命周期,而且,在使用时也希望得到更加灵活的参数配置,因此在使用时大多采用如下的配置:
<plugin>
<groupId>com.taobao.maven</groupId>
<artifactId>maven-hello-plugin</artifactId>
<version>1.0-SNAPSHOT</version>
<executions>
<execution>
<id>compile phase</id>
<phase>compile</phase>
<goals>
<goal>greeting</goal>
</goals>
<configuration>
<words>hello everyone</words>
</configuration>
</execution>
<execution>
<id>test phase</id>
<phase>test</phase>
<goals>
<goal>goodBye</goal>
</goals>
<configuration>
<words>goodbye everyone</words>
</configuration>
</execution>
</executions>
</plugin>
这个配置对这个插件定义了运行时的生命周期,在编译compile阶段运行插件的greeting 目标,输出greeting.words是“hello everyone”;在测试test阶段运行插件的goodBye 目标,输出goodBye.words是“goodbye everyone”。配置完成后,回到命令行的plugin-test工程目录下运行:mvn clean package,即可看到对应阶段的输出信息。
分享到:
相关推荐
Eclipse作为流行的Java集成开发环境,为了方便开发者使用Maven,提供了Maven插件。本篇文章将详细解析如何在Eclipse中离线安装Maven插件,同时提供内附的Maven插件包,以解决在线安装过程中的速度问题和可能遇到的...
现在eclipse的社区版都不内置maven插件了,站点在线安装实在是太痛苦了(我装了6个小时),于是急于寻找一种离线安装的办法,可是在网上又找不到对应的m2e包(我用的eclipse4.7),于是我决定将站点下的文件(很多)...
总之,MyEclipse集成Maven插件为开发者提供了更高效的工作环境,使得在IDE内就能完成大部分项目管理和构建任务,提高了开发效率。通过熟悉和掌握这些知识,可以更好地利用MyEclipse和Maven提升软件开发质量。
Eclipse的Maven插件是开发Java项目时不可或缺的工具,它将强大的Maven构建系统与流行的Eclipse集成开发环境(IDE)相结合,为开发者提供了一站式解决方案。Maven是一个项目管理和综合工具,它通过定义项目的结构和...
总结来说,MyEclipse 6.5的Maven插件是Java开发者必备的工具之一,它简化了项目构建和依赖管理,提高了开发效率,而其离线安装和良好的拔插性更是为不同环境下的开发工作提供了便利。正确理解和熟练使用Maven插件,...
Eclipse是一款广受欢迎的Java开发集成环境,而Maven则是一个强大的项目管理和构建工具,它遵循约定优于配置的原则,能够帮助开发者管理项目依赖、构建、报告等任务。然而,在某些网络环境不佳的情况下,Eclipse可能...
Eclipse是一款广泛使用的Java开发集成环境,而Maven是一个强大的项目管理和构建工具,它通过一个中央仓库...在日常开发中,记得定期更新Maven插件以获取最新的功能和修复,保持与Maven的同步,以确保最佳的开发体验。
通过Maven插件,Eclipse用户可以直接在IDE内部创建、编译、测试、打包和部署Maven项目,极大地提高了开发效率。 安装Maven插件的过程通常分为以下几步: 1. **下载Maven**:首先,你需要从Apache官方网站...
5. **配置Maven插件**: 在Jenkins中配置Maven插件,你需要提供Maven的安装路径,以便Jenkins在构建过程中调用Maven。这可以在Jenkins全局工具配置中完成,也可以在每个具体的Maven项目配置中设置。 6. **使用Maven...
Eclipse作为流行的Java集成开发环境(IDE),通过安装Maven插件,可以让开发者在Eclipse内部方便地进行Maven项目的开发和管理。下面我们将详细介绍如何在Eclipse中安装Maven插件。 首先,我们需要知道为什么要在...
总的来说,自定义Maven插件是提升开发效率、实现个性化需求的重要手段。开发者需要理解Maven的生命周期和插件机制,才能灵活地设计和实现自定义插件。同时,良好的文档和测试也是确保插件质量的关键。
本文将详细讲解如何在Jenkins中安装Git和Maven插件,以便实现版本控制与构建管理。 首先,让我们了解Jenkins插件的作用。Jenkins通过插件扩展其功能,提供对各种工具和技术的支持。Git插件允许Jenkins与Git仓库进行...
** Maven 插件压缩包详解 ** Maven 是一个强大的项目管理工具,...通过以上步骤,你可以在离线环境下有效地使用 Maven 插件,提高开发效率。参考链接中的博客文章提供了更详细的步骤和示例,可以进一步了解如何操作。
Maven通过使用一种标准化的项目对象模型(Project Object Model,POM)以及一套预定义的生命周期和构建阶段,使得Java开发变得更加简单。本话题将深入探讨“Maven插件手动下载”的过程及相关知识点。 Maven插件是...
### MyEclipse10安装与配置Maven插件详尽指南 #### 一、Maven简介及重要性 Maven是一款强大的项目管理工具,主要用于Java项目的构建、依赖管理和项目信息管理。通过Maven,开发者可以方便地管理项目的依赖关系、...