文档章节

Maven Plugin示例:自己动手编写Maven插件

独钓渔
 独钓渔
发布于 2017/08/31 16:21
字数 1084
阅读 265
收藏 0

重要声明:插件命名规范和Apache Maven商标

通常将你的插件命名为<yourplugin>-maven-plugin。
强烈反对命名为maven-<yourplugin>-plugin(maven在插件名开头),因为这是Apache Maven组织为官方Maven插件保留的命名格式,用org.apache.maven.plugins作为组id。使用此命名是对Apache Maven商标的侵权。

一: 知识要点

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

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

2,pom.xml文件中,打包(packaging)类型应该为 maven-plugin,而不是war/jar。同时需要依赖的两个核心依赖是:

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

3,开发Maven插件和开发普通的Maven工程的流程是一样的,不同在于插件的 archetype应该设置为:maven-archetype-plugin;

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

@Mojo( name = "doSomething")
public class GreetingMojo extends AbstractMojo{
...
}
mvn groupId:artifactId:version:doSomething  //如果一个项目中只version时,则version可以省略,只有一个@Mojo标记,估计后面的Mojo名称估计可以省略。

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

	<build>
		<plugins>
			<plugin>
				<groupId>com.imddy.plugin</groupId>
				<artifactId>ddyhello-maven-plugin</artifactId>
				<version>0.0.1-SNAPSHOT</version>
				<configuration>
                    <port>8090</port>
                </configuration>
			</plugin>
		</plugins>


	</build>

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-archetype-plugin的maven项目

选择好项目的ArifactId, xxxx-maven-plugin

项目会知道安装maven-tools工具

会自动生成

package com.imddy.plugin.ddyhello_maven_plugin;



import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;

import org.apache.maven.plugins.annotations.LifecyclePhase;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.plugins.annotations.ResolutionScope;

import java.io.File;
import java.io.FileWriter;
import java.io.IOException;

/**
 * Goal which touches a timestamp file.
 *
 * @deprecated Don't use!
 */
@Mojo(name = "touch", defaultPhase = LifecyclePhase.PROCESS_SOURCES)
public class MyMojo extends AbstractMojo {
	/**
	 * Location of the file.
	 */
	@Parameter(defaultValue = "${project.build.directory}", property = "outputDir", required = true)
	private File outputDirectory;

	public void execute() throws MojoExecutionException {
		File f = outputDirectory;

		if (!f.exists()) {
			f.mkdirs();
		}

		File touch = new File(f, "touch.txt");

		FileWriter w = null;
		try {
			w = new FileWriter(touch);

			w.write("touch.txt");
		} catch (IOException e) {
			throw new MojoExecutionException("Error creating file " + touch, e);
		} finally {
			if (w != null) {
				try {
					w.close();
				} catch (IOException e) {
					// ignore
				}
			}
		}
	}
}

上面这个是自动生成的一个代码,使用了Mojo注解为touch

当我们使用

com.imddy.plugin:ddyhello-maven-plugin:touch

这是在另一个项目的测试结果为

 

除了默认的,我可以自己手动写的代码如下:

package com.imddy.plugin.ddyhello;

import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.Parameter;

@Mojo(name = "drive")
public class Car extends AbstractMojo {

    @Parameter(defaultValue = "8080")
    private Integer port;
    
    public void execute() throws MojoExecutionException, MojoFailureException {
    	getLog().info( "Hello, world." );
        System.out.println("Car drive...");
        System.out.println(port);
    }

}

1 getLog().info()这个是日志输出,写maven最好不要使用其它的日志。

2 @Parameter(defaultValue = "8080")
    private Integer port;

Paramter可以用来设置参数这个参数也可以在pom.xml中配置

	<build>
		<plugins>
			<plugin>
				<groupId>com.imddy.plugin</groupId>
				<artifactId>ddyhello-maven-plugin</artifactId>
				<version>0.0.1-SNAPSHOT</version>
				<configuration>
                    <port>8090</port>
                </configuration>
			</plugin>
		</plugins>


	</build>

不配置会输出默认值。

使用命令如下:

com.imddy.plugin:ddyhello-maven.plugin:driver

如果插件需要绑定在某个阶段

<build>
		<plugins>
			<plugin>
				<groupId>com.imddy.plugin</groupId>
				<artifactId>ddyhello-maven-plugin</artifactId>
				<version>0.0.1-SNAPSHOT</version>
				<configuration>
                    <port>8090</port>
                </configuration>
                <executions>
                    <execution>
                    <phase>compile</phase>
                    <goals>
                        <goal>doSomething</goal>
                    </goals>
                    </execution>
                </executions>
			</plugin>
		</plugins>


</build>

 

 

© 著作权归作者所有

共有 人打赏支持
独钓渔
粉丝 47
博文 375
码字总数 142587
作品 0
沙坪坝
系统管理员
私信 提问
黄勇/smart-framework

Smart Framework 简介 1. 它是一款轻量级 Java Web 框架 内置 IOC、AOP、ORM、DAO、MVC 等特性 基于 Servlet 3.0 规范 使用 Java 注解取代 XML 配置 2. 它使应用充分做到“前后端分离” 客户...

黄勇
2013/09/23
0
0
常用Maven插件介绍(上)

转自 : http://www.infoq.com/cn/news/2011/04/xxb-maven-7-plugin 我们都知道Maven本质上是一个插件框架,它的核心并不执行任何具体的构建任务,所有这些任务都交给插件来完成,例如编译源...

long0404
2016/06/16
0
0
常用Maven 插件总结

一. 打包类 1. Shade Plugin 用来打可执行的Jar包 示例: <build> <finalName>storm-start-${project.version}</finalName> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupI......

marvin_vov
2015/10/20
1K
0
常用Maven插件介绍(转载)

转自:http://www.cnblogs.com/crazy-fox/archive/2012/02/09/2343722.html 我们都知道Maven本质上是一个插件框架,它的核心并不执行任何具体的构建任务,所有这些任务都交给插件来完成,例如...

晴天哥
2017/10/18
0
0
Maven实战(七)——常用Maven插件介绍(上)

我们都知道Maven本质上是一个插件框架,它的核心并不执行任何具体的构建任务,所有这些任务都交给插件来完成,例如编译源代码是由maven- compiler-plugin完成的。进一步说,每个任务对应了一...

有事没事
2016/09/21
6
0

没有更多内容

加载失败,请刷新页面

加载更多

多表查询

第1章 多表关系实战 1.1 实战1:省和市  方案1:多张表,一对多  方案2:一张表,自关联一对多 1.2 实战2:用户和角色 (比如演员和扮演人物)  多对多关系 1.3 实战3:角色和权限 (比如...

stars永恒
今天
7
0
求推广,德邦快递坑人!!!!

完全没想好怎么来吐槽自己这次苦逼的德邦物流过程了,只好来记一个流水账。 从寄快递开始: 2019年1月15日从 德邦物流 微信小app上下单,截图如下: 可笑的是什么,我预约的是17号上门收件,...

o0无忧亦无怖
昨天
7
0
Mac Vim配置

1.升级 vim   我自己 MacBook Pro 的系统还是 10.11 ,其自带的 vim 版本为 7.3 ,我们将其升至最新版: 使用 homebrew : brew install vim --with-lua --with-override-system-vim 这将下...

Pasenger
昨天
8
0
vmware安装Ubuntu上不了网?上网了安装不了net-tools,无法执行ifconfig?

1.重新设置网络适配器还是不行,如下指定nat 2.还需要指定共享网络,我是在无线环境下 3.无法执行ifconfig https://packages.ubuntu.com/bionic/net-tools到这个网站下载net-tools的deb文件...

noob_chr
昨天
6
0
解决SVN:E210007无法协商认证机制

svn:E210007 svn: Cannot negotiate authentication mechanism 执行下面代码即可 sudo yum install cyrus-sasl cyrus-sasl-plain cyrus-sasl-ldap...

临江仙卜算子
昨天
5
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部