Maven插件开发

Maven为我们提供了丰富的插件资源,使得开发调试过程中非常方便,可以满足大多数场景下的需求。当然有时候,我们也需要根据需求定制自己的插件。下面是在开发Maven插件时的一点备忘录,具体的开发流程请Google,有不少的教程,这里只是概述一下,同时记录一些容易掉坑的点。

1,Maven的工具由一个又一个的插件组成的,插件类继承了AbstractMojo类,需要覆写execute方法。getLog()获取的是AbstractMojo内部的log,类型是:org.apache.maven.plugin.logging.Log; 在Mojo的开发中,不要使用其他的Log基础设施。注: Mojo = Maven Old JavaObject;

public class Example extends AbstractMojo{
public void execute() throws MojoExecutionException, MojoFailureException {
getLog().info("Hello world");
}
}

2,pom.xml文件中,打包(packaging)类型应该为 maven-plugin,而不是war/jar。同时需要依赖的两个核心依赖是:
3,开发Maven插件和开发普通的Maven工程的流程是一样的,不同在于插件的 archetype应该设置为:maven-archetype-plugin;

  • maven-plugin-api:这是插件开发的api;
  • maven-plugin-annotations:这是进行插件注解的api。

4,插件的入口类为继承了AbstractMojo的实现类,但是需要进行注解。注解@Mojo是必须要的,这是定义插件对象的启动方法,由于该类只有一个方法,所以启动方法和启动类是一致的。在Maven 3之前是使用注释注解:@goal doSomething这种方式。现在已经不使用这种方式了。举个例子,如果进行如下标注:

@Mojo( name = "doSomething")
public class GreetingMojo extends AbstractMojo{
...
}

那么运行的时候使用如下方式执行:

mvn groupId:artifactId:version:doSomething  //如果一个项目中只有一个@Mojo标记,则verison可以省略

5,除了标注执行的方法,还可对成员变量进行标注,以便自动获取或由用户传入参数。

@Parameter( property = "greeting", defaultValue = "Hello World!" )   //这是由用户传入的参数,可以在命令行中由-D参数传入
private String greeting; @Parameter( expression = "${project}", defaultValue = "${project}" ) //还可以使用表达式,引用Maven工程中定义好的变量
private String project;

6,每个Mojo(由@Mojo标注)都有生命周期,即该Mojo的执行时间。用户可以选择将某个插件目标绑定到生命周期的某个阶段,从而让构建过程更为完善。生命周期的具体介绍参考文末给出的文章。下面将插件配置到编译阶段执行:

<build>
<plugins>
<plugin>
<groupId>sample.plugin</groupId>
<artifactId>doSomething-maven-plugin</artifactId>
<version>1.0-SNAPSHOT</version>
<executions>
<execution>
<phase>compile</phase>
<goals>
<goal>doSomething</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

总体来说Maven插件的开发思路还是比较清晰的。

参考资料:

  1. Guide to Developing Java Plugins
  2. maven的生命周期和插件
  3. Maven生命周期以及插件详解
 
上一篇:WPF关于“在“System.Windows.Markup.StaticResourceHolder”上提供值时引发了异常。”问题解决办法


下一篇:vue+element-ui中的表单验证(电话等等)