-
Maven插件开发教程
Maven是一个一个优秀的项目管理开源框架，其插件机制为其功能扩展提供了非常大的便捷性。大多数情况下，我们不需要自己开发Maven插件，因为Maven本身提供了很多便捷的官方插件。但是对于某些特殊场景和特殊需求，开发一个自定义的Maven插件能大大提高开发效率。本文以一个简单的例子，展示如何创建一个自定义的Maven插件。
Maven插件开发
本文会以一个自制的Maven插件为例，展示如何使用Idea从0开始构建自制的Maven插件。
Maven插件目标
Maven本质是一个插件执行框架，所有的工作都是通过插件完成的。包括常见的命令如install/clean/deploy/compiler这些命令，其实底层都是一个一个的Maven插件的执行结果。
插件目标：开发一个自制的Maven插件，插件名称叫demo-test-maven-plugin，该插件包含两个Goal：
-
goal1：执行命令
mvn demo-test:goal1，控制台输出This is goal1.； -
goal2：执行命令
mvn demo-test:goal2，向控制台输出This is goal2.；
插件项目命名
在开发Maven插件之前，第一件事是确定插件项目名称。Maven插件有特定的命名规范，命名规范分为两种类型：
-
官方插件项目命名规范：
maven-xxx-plugin，其中插件名为xxx，在Maven中可以使用命令mvn xxx调用插件； -
自定义插件项目命名规范：
xxx-maven-plugin，其中插件名为xxx，在Maven中可以使用命令mvn xxx调用插件；
我们的插件是自定义插件，插件名为demo-test，所以插件的项目名称为demo-test-maven-plugin。
建立插件项目
确定好建立的项目名称为demo-test-maven-plug之后，我们就可以去实际创建一个项目。本节以Idea作为工具，介绍如何建立一个Maven插件项目。
-
Idea中新建Maven项目，并选择
org.apache.maven.archetypes:maven-archetype-mojo作为项目模板；
-
Idea中输入项目名称，点击确认；
-
最后一步，点击
Finish按钮，完成项目的创建；
通过以上步骤，我们创建了一个空的Maven插件项目，这个项目目前没有任何代码。
插件项目分析
通过上述步骤，我们创建好了一个空的Maven项目，项目的目录如下所示：
![创建项目4]
自动生成的项目POM文件内容如下所示，其中有以下几点比较关键：
-
packaging：普通Java项目的packaging是jar/war/pom，但是Maven插件项目的packaging是maven-plugin； -
maven-plugin-api：Maven插件项目依赖了maven-plugin-api包，这是Maven插件项目必须依赖的核心包；
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.demo.test</groupId>
<artifactId>demo-test-maven-plug</artifactId>
<packaging>maven-plugin</packaging>
<version>1.0-SNAPSHOT</version>
<name>demo-test-maven-plug Maven Mojo</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>org.apache.maven</groupId>
<artifactId>maven-plugin-api</artifactId>
<version>2.0</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
自动生成的项目中还包含一个Java文件，内容如下所示，这个Java文件有几个特点：
-
生成的类继承了
AbstractMojo，这里是Maven插件的规范要求，Maven插件必须要继承AbstractMojo并抽象的execute方法； -
类与方法上有一些
Tag，如@goal。Tag和注解不同，Tag会出现在相关文档中； -
Tag@goal的作用是指定插件的命名，如命令mvn clean中，clean就是@goal； -
Tag@phase的作用是绑定插件执行的生成周期，如clean周期，那么在执行mvn clean时会自动触发插件； -
Tag@parameter用来指定插件的参数。
Tag机制有很多问题，如没有语法报错等，Maven为什么会使用Tag而不是注解呢呢？这是因为Java早期不支持注解，JDK1.5才开始添加注解功能。Maven开发之初没有注解，所以只能使用Tag来代替，新版本的Maven中已经可以使用注解来代替Tag。
package org.demo.test;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
/**
* Goal which touches a timestamp file.
*
* @goal touch
*
* @phase process-sources
*/
public class MyMojo
extends AbstractMojo
{
/**
* Location of the file.
* @parameter expression="${project.build.directory}"
* @required
*/
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
}
}
}
}
}
修改项目POM
默认的POM版本比较老，功能缺失，所以在开发之前需要修改自动生成项目中的POM：
- 升级maven-plugin-api包版本到3.8.3。自动生成POM的版本是低版本的2.0；
- 添加maven-plugin-annotations依赖，这个包内包含了Maven相关的注解，可以取代Tag；
- 添加maven-plugin-plugin插件依赖，这个包可以使插件支持JDK1.8以上的版本；
修改之后的POM如下所示：
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.demo.test</groupId>
<artifactId>demo-test-maven-plugin</artifactId>
<packaging>maven-plugin</packaging>
<version>1.0-SNAPSHOT</version>
<name>demo-test-maven-plug Maven Mojo</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>org.apache.maven</groupId>
<artifactId>maven-plugin-api</artifactId>
<version>3.8.3</version>
</dependency>
<dependency>
<groupId>org.apache.maven.plugin-tools</groupId>
<artifactId>maven-plugin-annotations</artifactId>
<version>3.6.1</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-plugin-plugin</artifactId>
<version>3.6.1</version>
</plugin>
</plugins>
</build>
</project>
添加自定义Mojo
开篇说过，本文项目中的插件需要两个goal：
-
goal1：执行命令
mvn demo-test:goal1，控制台输出This is goal1.； -
goal2：执行命令
mvn demo-test:goal2，向控制台输出This is goal2.；
在Maven插件开发中，goal和Mojo类对应，所以我们也需要实现两个Mojo类，如下所示，和默认生成的Mojo类不同：
-
@Mojo注解：定义插件相关的信息，如name表示goal的名称； -
@Parameter注解：指定插件运行时使用的参数，name是参数名，defaultValue是默认值；
@Mojo(name = "goal1")
public class Goal1Mojo extends AbstractMojo {
@Parameter(name = "name", defaultValue = "test")
private String name;
public void execute() {
getLog().info("This is goal1.");
}
}
@Mojo(name = "goal2")
public class Goal2Mojo extends AbstractMojo {
@Parameter(name = "name", defaultValue = "test")
private String name;
public void execute() {
getLog().info("This is goal2.");
}
}
插件的使用
通过上面的步骤，我们简单实现了一个Maven插件，插件的名称是demo-test，插件包含两个Goal：goal1和goal2，接下来，我们把插件项目编译并发布，编译和发布的步骤此处不做详细介绍。
项目编译发布好之后，我们在另外一个项目的POM中引入该插件：
<build>
<plugins>
<plugin>
<groupId>org.demo.test</groupId>
<artifactId>demo-test-maven-plugin</artifactId>
<version>1.0-SNAPSHOT</version>
</plugin>
</plugins>
</build>
-
在项目的命令行执行
mvn demo-test:goal1，可以看到以下输出：
[INFO] Scanning for projects...
[INFO]
[INFO] ---------------------< com.example:javafx-spring >----------------------
[INFO] Building javafx-spring 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- demo-test-maven-plugin:1.0-SNAPSHOT:goal1 (default-cli) @ javafx-spring ---
[INFO] This is goal1.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.470 s
[INFO] Finished at: 2021-11-18T17:55:11+08:00
[INFO] ------------------------------------------------------------------------
-
在项目的命令行执行
mvn demo-test:goal2，可以看到以下输出：
[INFO] Scanning for projects...
[INFO]
[INFO] ---------------------< com.example:javafx-spring >----------------------
[INFO] Building javafx-spring 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- demo-test-maven-plugin:1.0-SNAPSHOT:goal2 (default-cli) @ javafx-spring ---
[INFO] This is goal2.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.540 s
[INFO] Finished at: 2021-11-18T17:57:46+08:00
[INFO] ------------------------------------------------------------------------
至此，我们的Maven插件已经开发完成，达到最开始设定的目的。
附录1：Maven注解详解
import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecution;
import org.apache.maven.plugin.descriptor.PluginDescriptor;
import org.apache.maven.plugins.annotations.Component;
import org.apache.maven.plugins.annotations.Execute;
import org.apache.maven.plugins.annotations.InstantiationStrategy;
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 org.apache.maven.project.MavenProject;
import org.apache.maven.settings.Settings;
// 此Mojo对应的目标的名称
@Mojo( name = "<goal-name>",
aggregator = <false|true>,
configurator = "<role hint>",
// 执行策略
executionStrategy = "<once-per-session|always>",
inheritByDefault = <true|false>,
// 实例化策略
instantiationStrategy = InstantiationStrategy.<strategy>,
// 如果用户没有在POM中明确设置此Mojo绑定到的phase，那么绑定一个MojoExecution到那个phase
defaultPhase = LifecyclePhase.<phase>,
requiresDependencyResolution = ResolutionScope.<scope>,
requiresDependencyCollection = ResolutionScope.<scope>,
// 提示此Mojo需要被直接调用（而非绑定到生命周期阶段）
requiresDirectInvocation = <false|true>,
// 提示此Mojo不能在离线模式下运行
requiresOnline = <false|true>,
// 提示此Mojo必须在一个Maven项目内运行
requiresProject = <true|false>,
// 提示此Mojo是否线程安全，线程安全的Mojo支持在并行构建中被并发的调用
threadSafe = <false|true> ) // (since Maven 3.0)
// 何时执行此Mojo
@Execute( goal = "<goal-name>", // 如果提供goal，则隔离执行此Mojo
phase = LifecyclePhase.<phase>, // 在此生命周期阶段自动执行此Mojo
lifecycle = "<lifecycle-id>" ) // 在此生命周期中执行此Mojo
public class MyMojo
extends AbstractMojo
{
@Parameter( name = "parameter",
// 在POM中可使用别名来配置参数
alias = "myAlias",
property = "a.property",
defaultValue = "an expression, possibly with ${variables}",
readonly = <false|true>,
required = <false|true> )
private String parameter;
@Component( role = MyComponentExtension.class,
hint = "..." )
private MyComponent component;
@Parameter( defaultValue = "${session}", readonly = true )
private MavenSession session;
@Parameter( defaultValue = "${project}", readonly = true )
private MavenProject project;
@Parameter( defaultValue = "${mojoExecution}", readonly = true )
private MojoExecution mojo;
@Parameter( defaultValue = "${plugin}", readonly = true )
private PluginDescriptor plugin;
@Parameter( defaultValue = "${settings}", readonly = true )
private Settings settings;
@Parameter( defaultValue = "${project.basedir}", readonly = true )
private File basedir;
@Parameter( defaultValue = "${project.build.directory}", readonly = true )
private File target;
public void execute()
{
}
}
原文：https://www.cnblogs.com/yuhushen/p/15783559.html
最新更新
python爬虫及其可视化
使用python爬取豆瓣电影短评评论内容
nodejs爬虫
Python正则表达式完全指南
爬取豆瓣Top250图书数据
shp 地图文件批量添加字段
爬虫小试牛刀（爬取学校通知公告）
【python基础】函数-初识函数
【python基础】函数-返回值
HTTP请求：requests模块基础使用必知必会
SQL SERVER中递归
2个场景实例讲解GaussDB(DWS)基表统计信息估
常用的 SQL Server 关键字及其含义
动手分析SQL Server中的事务中使用的锁
openGauss内核分析：SQL by pass & 经典执行
一招教你如何高效批量导入与更新数据
天天写SQL，这些神奇的特性你知道吗？
openGauss内核分析：执行计划生成
[IM002]Navicat ODBC驱动器管理器 未发现数据
初入Sql Server 之 存储过程的简单使用
uniapp/H5 获取手机桌面壁纸 (静态壁纸）
[前端] DNS解析与优化
为什么在js中需要添加addEventListener（）？
JS模块化系统
js通过Object.defineProperty() 定义和控制对象
这是目前我见过最好的跨域解决方案！
减少回流与重绘
减少回流与重绘
如何使用KrpanoToolJS在浏览器切图
performance.now() 与 Date.now() 对比