设计自己的maven插件

maven系列目标:从入门开始开始掌握一个高级开发所需要的maven技能。

这是maven系列第10篇。

整个maven系列的内容前后是有依赖的,如果之前没有接触过maven,建议从第一篇看起,本文尾部有maven完整系列的连接。

Maven默认提供了很多插件,功能也非常强大,但是如果我们想自己开发一些插件,比如自定义一款自动打包并且发布到服务器然后重启服务器的插件;或者定义一款插件自动打包自动运行打包好的构件。各种好玩的东西只要你能想到,都可以通过maven插件去完成,不过我们需要先了解如何自定义maven插件。

必备知识
Maven系列第6篇:生命周期和插件详解,高手必备!

本篇环境
jdk1.8

maven3.6.2

idea

本章内容
自定义插件详细步骤

自定义插件参数的使用

自定义插件前缀的使用

手动实现打包之后自动运行的插件

自定义插件详细步骤
maven中的插件是有很多目标(goal)组成的,开发插件,实际上就是去编写插件中目标的具体代码。每个目标对应一个java类,这个类在maven中叫做MOJO,maven提供了一个Mojo的接口,我们开发插件也就是去实现这个接口的方法,这个接口是:

org.apache.maven.plugin.Mojo
接口有3个方法:

void execute() throws MojoExecutionException, MojoFailureException;
void setLog( Log log );
Log getLog();
execute:这个方法比较重要,目标的主要代码就在这个方法中实现,当使用mvn命令调用插件的目标的时候,最后具体调用的就是这个方法。

setLog:注入一个标准的Maven日志记录器,允许这个Mojo向用户传递事件和反馈

getLog:获取注入的日志记录器

说一下上面这个Log,这是一日志接口,里面定义了很多方法,主要用户向交互者输出日志,比如我们运行mvn clean,会输出很多提示信息,这些输出的信息就是通过Log来输出的。

Mojo接口有个默认的抽象类:

org.apache.maven.plugin.AbstractMojo
这个类中把Mojo接口中的setLog和getLog实现了,而execute方法没有实现,交给继承者去实现,这个类中Log默认可以向控制台输出日志信息,maven中自带的插件都继承这个类,一般情况下我们开发插件目标可以直接继承这个类,然后实现execute方法就可以了。

实现一个插件的具体步骤
1、 创建一个maven构件,这个构件的packaging比较特殊,必须为maven-plugin,表示这个构件是一个插件类型,如下:
pom.xml中的packageing元素必须如下值:

maven-plugin
2、导入maven插件依赖:

    org.apache.maven
    maven-plugin-api
    3.0

    org.apache.maven.plugin-tools     maven-plugin-annotations     3.4     provided 3、创建一个目标类,需要继承org.apache.maven.plugin.AbstractMojo 4、目标类中添加注解@Mojo注解: @org.apache.maven.plugins.annotations.Mojo(name="目标名称") 注意@Mojo注解用来标注这个类是一个目标类,maven对插件进行构建的时候会根据这个注解来找到这个插件的目标,这个注解中还有其他参数,后面在详细介绍。

5、在目标类的execute方法中实现具体的逻辑
6、安装插件到本地仓库:插件的pom.xml所在目录执行下面命令
mvn clean install
或者可以部署到私服仓库,部署方式和其他构件的方式一样,这个具体去看前面文章的私服的文章。

7、让使用者去使用插件
案例1
下面我们来实现我们第一个插件,插件构件信息:

com.javacode2018
demo1-maven-plugin
1.0-SNAPSHOT
maven-plugin
创建一个目标类demo1,调用这个目标的时候,希望他能够输出:

hello my first maven plugin!
创建一个maven项目
打开idea,点击File->New->Project,如下图:

选择Maven,如下图:

点击上图中的Next,如下图,输入项目坐标信息:

点击上图中的Next,如下图,输入Project name为maven-chat10:

点击上图中的Finish,完成创建,如下图:

配置一下idea的maven环境,点击File->Settings,如下图:

删除下面2个无用的文件夹:

创建插件模块demo1-maven-plugin
这次用idea创建一个插件模块demo1-maven-plugin,具体过程如下。

在刚才的maven-chat10项目窗口中,点击File->Project Structure,如下图:

也可以使用快捷键Ctrl+Alt+Shift+S打开

选择上图找你的Modules,如下图:

点击+,如下图:

选择上图中的New Module,如下图:

选择上图左侧的Maven,如下图:

点击上图中的Next,如下图:

将Add as module to设置为maven-chat10,如下图:

上图中输入坐标信息,如下图:

点击上图中的Next,默认如下图:

修改上图中Module name为demo1-maven-plugin,如下图:

点击上图的Finish,如下图:

点击上图中的OK按钮,完成创建工作,目前项目结构如下图:

设置demo1-maven-plugin/pom.xml中packaging的值为maven-plugin,如下
maven-plugin
demo1-maven-plugin/pom.xml引入插件需要的依赖

    org.apache.maven
    maven-plugin-api
    3.0

    org.apache.maven.plugin-tools     maven-plugin-annotations     3.4     provided 最后demo1-maven-plugin/pom.xml内容如下 <?xml version="1.0" encoding="UTF-8"?>


    4.0.0

com.javacode2018
    demo1-maven-plugin
    1.0-SNAPSHOT
    
    maven-plugin


        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
        
        <maven.compiler.source>1.8</maven.compiler.source>
        
        <maven.compiler.target>1.8</maven.compiler.target>
    


        
        
            org.apache.maven
            maven-plugin-api
            3.0
        


            org.apache.maven.plugin-tools
            maven-plugin-annotations
            3.4
            provided
        
        
    


        
            
                org.apache.maven.plugins
                maven-plugin-plugin
                3.4
            
        
    

创建目标类 在demo-maven-plugin中创建的目标类com.javacode2018.Demo1Mojo,需要继承org.apache.maven.plugin.AbstractMojo,需要实现@Mojo注解,如下:

package com.javacode2018;

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;

/**
 * 工作10年的前阿里P7分享Java、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:路人甲Java
 */
@Mojo(name = “demo1”)
public class Demo1Mojo extends AbstractMojo {
    public void execute() throws MojoExecutionException, MojoFailureException {
    }
}
注意上面注解@Mojo(name = “demo1”),name使用来标注目标的名称为demo1。

实现目标类的execute方法
我们在execute方法中输出一句话

this.getLog().info(“hello my first maven plugin!”);
目前execute方法代码如下:

public void execute() throws MojoExecutionException, MojoFailureException {
    this.getLog().info(“hello my first maven plugin!”);
}
安装插件到本地仓库
在maven-chat10/pom.xml目录执行下面命令:

mvn clean install -pl :demo1-maven-plugin
注意上面命令和在demo1-maven-plugin/pom中执行mvn clean install效果是一样的,只是这个地方使用了maven裁剪的功能,对这块命令不熟悉的可以看:Maven系列第8篇:大型Maven项目,快速按需任意构建,必备神技能!

上面命令效果如下:

D:\code\IdeaProjects\maven-chat10>mvn clean install -pl :demo1-maven-plugin
[INFO] Scanning for projects…
[INFO]
[INFO] ----------------< com.javacode2018:demo1-maven-plugin >-----------------
[INFO] Building demo1-maven-plugin 1.0-SNAPSHOT
[INFO] ----------------------------[ maven-plugin ]----------------------------
[INFO]
[INFO] — maven-clean-plugin:2.5:clean (default-clean) @ demo1-maven-plugin —
[INFO] Deleting D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\target
[INFO]
[INFO] — maven-resources-plugin:2.6:resources (default-resources) @ demo1-maven-plugin —
[INFO] Using ‘UTF-8’ encoding to copy filtered resources.
[INFO] Copying 0 resource
[INFO]
[INFO] — maven-compiler-plugin:3.1:compile (default-compile) @ demo1-maven-plugin —
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\target\classes
[INFO]
[INFO] — maven-plugin-plugin:3.4:descriptor (default-descriptor) @ demo1-maven-plugin —
[INFO] Using ‘UTF-8’ encoding to read mojo metadata.
[INFO] Mojo extractor with id: java-javadoc found 0 mojo descriptors.
[INFO] Mojo extractor with id: java-annotations found 1 mojo descriptors.
[INFO]
[INFO] — maven-resources-plugin:2.6:testResources (default-testResources) @ demo1-maven-plugin —
[INFO] Using ‘UTF-8’ encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\src\test\resources
[INFO]
[INFO] — maven-compiler-plugin:3.1:testCompile (default-testCompile) @ demo1-maven-plugin —
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] — maven-surefire-plugin:2.12.4:test (default-test) @ demo1-maven-plugin —
[INFO] No tests to run.
[INFO]
[INFO] — maven-jar-plugin:2.4:jar (default-jar) @ demo1-maven-plugin —
[INFO] Building jar: D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\target\demo1-maven-plugin-1.0-SNAPSHOT.jar
[INFO]
[INFO] — maven-plugin-plugin:3.4:addPluginArtifactMetadata (default-addPluginArtifactMetadata) @ demo1-maven-plugin —
[INFO]
[INFO] — maven-install-plugin:2.4:install (default-install) @ demo1-maven-plugin —
[INFO] Installing D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\target\demo1-maven-plugin-1.0-SNAPSHOT.jar to C:\Users\Think.m2\repository\com\javacode2018\demo1-maven-plugin\1.0-SNAPSHOT\demo1-maven-plugin-1.0-SNAPSHOT.jar
[INFO] Installing D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\pom.xml to C:\Users\Think.m2\repository\com\javacode2018\demo1-maven-plugin\1.0-SNAPSHOT\demo1-maven-plugin-1.0-SNAPSHOT.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  5.402 s
[INFO] Finished at: 2019-11-26T15:21:26+08:00
[INFO] ------------------------------------------------------------------------
验证插件,调用插件的demo1目标看效果
maven-chat10/pom.xml所在目录执行:

mvn com.javacode2018:demo1-maven-plugin:demo1
效果如下:

D:\code\IdeaProjects\maven-chat10>mvn com.javacode2018:demo1-maven-plugin:demo1
[INFO] Scanning for projects…
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] demo1-maven-plugin                                        [maven-plugin]
[INFO] maven-chat10                                                       [pom]
[INFO]
[INFO] ----------------< com.javacode2018:demo1-maven-plugin >-----------------
[INFO] Building demo1-maven-plugin 1.0-SNAPSHOT                           [1/2]
[INFO] ----------------------------[ maven-plugin ]----------------------------
[INFO]
[INFO] — demo1-maven-plugin:1.0-SNAPSHOT:demo1 (default-cli) @ demo1-maven-plugin —
[INFO] hello my first maven plugin!
[INFO]
[INFO] -------------------< com.javacode2018:maven-chat10 >--------------------
[INFO] Building maven-chat10 1.0-SNAPSHOT                                 [2/2]
[INFO] --------------------------------[ pom ]---------------------------------
[INFO]
[INFO] — demo1-maven-plugin:1.0-SNAPSHOT:demo1 (default-cli) @ maven-chat10 —
[INFO] hello my first maven plugin!
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for maven-chat10 1.0-SNAPSHOT:
[INFO]
[INFO] demo1-maven-plugin … SUCCESS [  0.358 s]
[INFO] maven-chat10 … SUCCESS [  0.042 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  0.656 s
[INFO] Finished at: 2019-11-26T13:49:30+08:00
上面输出的东西比较多,我们主要看一下有这样的一句输出,如下:

[INFO] hello my first maven plugin!
上面这个输出就是我们在execute方法中输出的内容。

目标中参数的使用
上面我们介绍了开发一个插件目标详细的实现过程,然后写了一个简单的案例,比较简单。不过自定义的Mojo如果没有参数,那么这个Mojo基本上也实现不了什么复杂的功能,下面我们来看一下Mojo中如何使用参数。

需要先在mojo中定义参数
定义参数就像在mojo中创建一个实例变量并添加适当的注释一样简单。下面列出了一个简单mojo的参数示例:

/**
 * 要显示的问候语。
 */
@Parameter( property = “sayhi.greeting”, defaultValue = “Hello World!” )
private String greeting;
@Parameter注解之前的部分是参数的描述,这个注解将变量标识为mojo参数。注解的defaultValue参数定义变量的默认值,此值maven的属性值,例如“${project.version}”(更多信息可以看上一篇文章中的 target="_blank">maven属性部分),property参数可用于通过引用用户通过-D选项设置的系统属性,即通过从命令行配置mojo参数,如mvn … -Dsayhi.greeting=路人甲Java可以将路人甲Java的值传递给greeting参数,这个注解还有几个属性大家有兴趣的可以自己去研究一下。

在pom.xml配置参数的值

  com.javacode2018
  demo1-maven-plugin
  1.0-SNAPSHOT
  
    欢迎您和【路人甲Java】一起学习Maven技术!
  

上面设置的是一个string类型的greeting参数的值,还有其他很多类型定义以及使用,我们也来看一下。

Boolean参数
/**
* My boolean.
*/
@Parameter
private boolean myBoolean;
true
数字类型参数
数字类型包含:byte, Byte, int, Integer, long, Long, short, Short,读取配置时,XML文件中的文本将使用适当类的integer.parseInt()或valueOf()方法转换为整数值,这意味着字符串必须是有效的十进制整数值,仅由数字0到9组成,前面有一个可选的-表示负值。例子:

/**
* My Integer.
*/
@Parameter
private Integer myInteger;
10
File类型参数
读取配置时,XML文件中的文本用作所需文件或目录的路径。如果路径是相对的(不是以/或C:之类的驱动器号开头),则路径是相对于包含POM的目录的。例子:

/**
* My File.
*/
@Parameter
private File myFile;
c:\temp
枚举类型参数
public enum Color {
      GREEN,
      RED,
      BLUE
}

/**
* My Enum
/
@Parameter
private Color myColor;
GREEN
数组类型参数
/
*
* My Array.
/
@Parameter
private String[] myArray;

  value1
  value2

Collections类型参数
/
*
* My List.
/
@Parameter
private List myList;

  value1
  value2

Maps类型参数
/
*
* My Map.
*/
@Parameter
private Map myMap;

  value1
  value2

Properties类型参数
java.util.Properties的类型

/**
* My Properties.
/
@Parameter
private Properties myProperties;

  
    propertyName1
    propertyValue1
  
  
    propertyName2
    propertyValue2
  

自定义类型参数
/
*
* My Object.
*/
@Parameter
private MyObject myObject;

  test

案例2
修改案例代码
我们将上面各种类型的参数都放到Demo1Mojo中,Demo1Mojo类如下:

package com.javacode2018;

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;

import java.io.File;
import java.lang.reflect.Field;
import java.util.Arrays;
import java.util.List;
import java.util.Map;
import java.util.Properties;

/**
 * 工作10年的前阿里P7分享Java、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:路人甲Java
 */
@Mojo(name = “demo1”)
public class Demo1Mojo extends AbstractMojo {

/**
     * 要显示的问候语。
     */
    @Parameter(property = “sayhi.greeting”, defaultValue = “Hello World!”)
    private String greeting;

/**
     * My boolean.
     */
    @Parameter
    private boolean myBoolean;

/**
     * My Integer.
     */
    @Parameter
    private Integer myInteger;

/**
     * My File.
     */
    @Parameter
    private File myFile;

public enum Color {
        GREEN,
        RED,
        BLUE
    }

/**
     * My Enum
     */
    @Parameter
    private Color myColor;

/**
     * My Array.
     */
    @Parameter
    private String[] myArray;

/**
     * My List.
     */
    @Parameter
    private List myList;

/**
     * My Map.
     */
    @Parameter
    private Map myMap;

/**
     * My Properties.
     */
    @Parameter
    private Properties myProperties;

public static class Person {
        private String name;
        private int age;

public String getName() {
            return name;
        }

public void setName(String name) {
            this.name = name;
        }

public int getAge() {
            return age;
        }

public void setAge(int age) {
            this.age = age;
        }

@Override
        public String toString() {
            return “Person{” +
                    “name=’” + name + ‘’’ +
                    “, age=” + age +
                    ‘}’;
        }
    }

@Parameter
    private Person person;

public void execute() throws MojoExecutionException, MojoFailureException {
        this.getLog().info(“hello my first maven plugin!”);

Field[] declaredFields = Demo1Mojo.class.getDeclaredFields();

Arrays.stream(declaredFields).forEach(f -> {
            if (f.isAccessible()) {
                f.setAccessible(true);
            }
            try {
                this.getLog().info(f.getName() + “:” + f.get(this));
            } catch (IllegalAccessException e) {
                this.getLog().warn(e);
            }
        });
    }
}
demo1-maven-plugin安装到本地仓库
maven-chat10/pom.xml所在目录运行:

mvn clean install -pl :demo1-maven-plugin
创建测试模块demo1-maven-plugin-test
使用idea创建,过程和demo1-maven-plugin过程类似,可以直接参考,创建好了,如下:

修改demo1-mavein-plugin-test/pom.xml文件,加入下面内容:

                          com.javacode2018             demo1-maven-plugin             1.0-SNAPSHOT                                                   demo1 plugin test                     pre-clean                                              demo1                                                                   true                         30                         ${project.basedir}                         BLUE                                                      maven                             spring                             mybatis                             springboot                             springcloud                                                                               30                             35                                                                               路人甲Java                             30                                                                                                                name                                 javacode2018                                                                                           age                                 30                                                                                                            路人甲Java                             32                                                                                           上面是将生命周期的pre-clean阶段绑定插件demo1-maven-plugin的demo1目标,并且设置了demo1目标所需要的所有参数的值。

验证效果
在maven-chat10/pom.xml所在目录执行:

D:\code\IdeaProjects\maven-chat10>mvn pre-clean -pl :demo1-maven-plugin-test -Dsayhi.greeting=“欢迎和【路人甲Java】一起学习Maven!”
[INFO] Scanning for projects…
[INFO]
[INFO] --------------< com.javacode2018:demo1-maven-plugin-test >--------------
[INFO] Building demo1-maven-plugin-test 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] — demo1-maven-plugin:1.0-SNAPSHOT:demo1 (demo1 plugin test) @ demo1-maven-plugin-test —
[INFO] hello my first maven plugin!
[INFO] greeting:欢迎和【路人甲Java】一起学习Maven!
[INFO] myBoolean:true
[INFO] myInteger:30
[INFO] myFile:D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-test
[INFO] myColor:BLUE
[INFO] myArray:[Ljava.lang.String;@7bf9b098
[INFO] myList:[30, 35]
[INFO] myMap:{age=30, name=路人甲Java}
[INFO] myProperties:{age=30, name=javacode2018}
[INFO] person:Person{name=‘路人甲Java’, age=32}
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  0.517 s
[INFO] Finished at: 2019-11-26T15:42:53+08:00
[INFO] ------------------------------------------------------------------------
插件前缀
在案例1中,我们使用下面命令调用的插件:

mvn com.javacode2018:demo1-maven-plugin:demo1
这种是采用下面这种格式:

mvn 插件groupId:插件artifactId[:插件版本]:插件目标名称
命令中插件版本是可以省略的,maven会自动找到这个插件最新的版本运行,不过最好我们不要省略版本号,每个版本的插件功能可能不一样,为了保证任何情况下运行效果的一致性,强烈建议指定版本号。

上面执行插件需要插件的坐标信息,一长串比较麻烦,maven也为了我们使用插件方便,提供了插件前缀来帮我们解决这个问题。

自定义插件前缀的使用
设置自定义插件的artifactId
自定义插件的artifactId满足下面的格式:

xxx-maven-plugin
如果采用这种格式的maven会自动将xxx指定为插件的前缀,其他格式也可以,不过此处我们只说这种格式,这个是最常用的格式。

如我们上面的demo1-maven-plugin插件,他的前缀就是demo1。

当我们配置了插件前缀,可以插件前缀来调用插件的目标了,命令如下:

mvn 插件前缀:插件目标
maven是如何通过插件前缀找到具体的插件的呢?

maven默认会在仓库"org.apache.maven.plugins" 和 "org.codehaus.mojo"2个位置查找插件,比如:

mvn clean:help
这个是调用maven-clean-plugin插件的help目标,maven-clean-plugin的前缀就是clean,他的groupId是org.apache.maven.plugins,所以能够直接找到。

但是我们自己定义的插件,如果也让maven能够找到,需要下面的配置。

~/.m2/settings.xml中配置自定义插件组
在pluginGroups中加入自定义的插件组groupId,如:

com.javacode2018
这样当我们通过前缀调用插件的时候,maven除了会在2个默认的组中查找,还会在这些自定义的插件组中找,一般情况下我们自定义的插件通常使用同样的groupId。

使用插件前缀调用插件
mvn 插件前缀:插件目标
案例3
在~/.m2/settings.xml中加入下面配置:

com.javacode2018
在maven-chat10/pom.xml所在目录执行:

mvn demo1:demo1 -pl demo1-maven-plugin-test
效果如下:

D:\code\IdeaProjects\maven-chat10>mvn demo1:demo1 -pl demo1-maven-plugin-test
[INFO] Scanning for projects…
[INFO]
[INFO] --------------< com.javacode2018:demo1-maven-plugin-test >--------------
[INFO] Building demo1-maven-plugin-test 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] — demo1-maven-plugin:1.0-SNAPSHOT:demo1 (default-cli) @ demo1-maven-plugin-test —
[INFO] hello my first maven plugin!
[INFO] greeting:Hello World!
[INFO] myBoolean:false
[INFO] myInteger:null
[INFO] myFile:null
[INFO] myColor:null
[INFO] myArray:null
[INFO] myList:null
[INFO] myMap:null
[INFO] myProperties:null
[INFO] person:null
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  0.786 s
[INFO] Finished at: 2019-11-26T16:10:41+08:00
[INFO] ------------------------------------------------------------------------
上面直接通过插件的前缀来调用插件的功能了,是不是很爽!

手动实现打包之后自动运行的插件
实现思路
1、将目标构件打包为可以执行jar包到target目录
maven中将构件打包为可以执行的jar的插件,maven已经帮我们提供了,如下:

    org.apache.maven.plugins     maven-shade-plugin     3.2.1                           package                              shade                                                                                         启动类完整路径                                                                  上面使用到了maven官方提供的一个打包的插件,可以将构件打包为可以直接运行的jar包。

2、自定义一个插件,然后执行上面打包好的插件
插件中需要通过java命令调用打包好的jar包,然后运行。

具体实现如下
创建自定义目标类
demo1-maven-plugin中创建一个插件目标类,如下:

package com.javacode2018;

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

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

/**
 * 工作10年的前阿里P7分享Java、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:路人甲Java
 */
@Mojo(name = “run”, defaultPhase = LifecyclePhase.PACKAGE)
@Execute(phase = LifecyclePhase.PACKAGE)
public class RunMojo extends AbstractMojo {

/**
     * 打包好的构件的路径
     */
    @Parameter(defaultValue = “${project.build.directory}\ p r o j e c t . a r t i f a c t I d − {project.artifactId}- project.artifactId{project.version}.jar”)
    private String jarPath;

@Override
    public void execute() throws MojoExecutionException, MojoFailureException {
        try {
            this.getLog().info(“Started:” + this.jarPath);
            ProcessBuilder builder = new ProcessBuilder(“java”, “-jar”, this.jarPath);
            final Process process = builder.start();

new Thread(() -> {
                BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()));
                try {
                    String s;
                    while ((s = reader.readLine()) != null) {
                        System.out.println(s);
                    }
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }).start();
            Runtime.getRuntime().addShutdownHook(new Thread() {
                @Override
                public void run() {
                    RunMojo.this.getLog().info(“Destroying…”);
                    process.destroy();
                    RunMojo.this.getLog().info(“Shutdown hook finished.”);
                }
            });

process.waitFor();
            this.getLog().info(“Finished.”);
        } catch (Exception e) {
            this.getLog().warn(e);
        }
    }
}
上面这个插件目标的名称为run

注意这个类上面多了一个注解@Execute,这个注解可以配置这个目标执行之前可以先执行的生命周期的阶段或者需要先执行的插件目标。

上面配置的是phase = LifecyclePhase.PACKAGE,也就是说当我们运行上面run目标的时候,会先执行构件的package阶段,也就是先执行项目的打包阶段,打包完成之后才会执行run目标。

安装插件到本地仓库
maven-chat10/pom.xml所在目录运行:

mvn clean install -pl :demo1-maven-plugin
创建测试模块demo1-maven-plugin-run
使用idea创建,过程和demo1-maven-plugin过程类似,可以直接参考,创建好了,如下:

创建com.javacode2018.Demo
在demo1-maven-plugin-run\src\main\java创建下面类:

package com.javacode2018;

import java.util.Calendar;
import java.util.concurrent.TimeUnit;

/**
 * 工作10年的前阿里P7分享Java、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:路人甲Java
 */
public class Demo1 {
    public static void main(String[] args) throws InterruptedException {
        for (int i = 0; i < 1000; i++) {
            System.out.println(Calendar.getInstance().getTime() + “:” + i);
            TimeUnit.SECONDS.sleep(1);
        }
    }
}
修改demo1-maven-plugin-run/pom.xml,如下

<?xml version="1.0" encoding="UTF-8"?>


    4.0.0

com.javacode2018
    demo1-maven-plugin-run
    1.0-SNAPSHOT


        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
        
        <maven.compiler.source>1.8</maven.compiler.source>
        
        <maven.compiler.target>1.8</maven.compiler.target>
    


        
            
                org.apache.maven.plugins
                maven-shade-plugin
                3.2.1
                
                    
                        package
                        
                            shade
                        
                        
                            
                                
                                    com.javacode2018.Demo1
                                
                            
                        
                    
                
            
        
    

验证效果见证奇迹的时刻
在maven-chat10/pom.xml所在目录执行下面的命令:

mvn clean demo1:run -pl demo1-maven-plugin-run
输出如下:

D:\code\IdeaProjects\maven-chat10>mvn clean demo1:run -pl demo1-maven-plugin-run
[INFO] Scanning for projects…
[INFO]
[INFO] --------------< com.javacode2018:demo1-maven-plugin-run >---------------
[INFO] Building demo1-maven-plugin-run 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] — maven-clean-plugin:2.5:clean (default-clean) @ demo1-maven-plugin-run —
[INFO] Deleting D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\target
[INFO]
[INFO] >>> demo1-maven-plugin:1.0-SNAPSHOT:run (default-cli) > package @ demo1-maven-plugin-run >>>
[INFO]
[INFO] — maven-resources-plugin:2.6:resources (default-resources) @ demo1-maven-plugin-run —
[INFO] Using ‘UTF-8’ encoding to copy filtered resources.
[INFO] Copying 0 resource
[INFO]
[INFO] — maven-compiler-plugin:3.1:compile (default-compile) @ demo1-maven-plugin-run —
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\target\classes
[INFO]
[INFO] — maven-resources-plugin:2.6:testResources (default-testResources) @ demo1-maven-plugin-run —
[INFO] Using ‘UTF-8’ encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\src\test\resources
[INFO]
[INFO] — maven-compiler-plugin:3.1:testCompile (default-testCompile) @ demo1-maven-plugin-run —
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] — maven-surefire-plugin:2.12.4:test (default-test) @ demo1-maven-plugin-run —
[INFO] No tests to run.
[INFO]
[INFO] — maven-jar-plugin:2.4:jar (default-jar) @ demo1-maven-plugin-run —
[INFO] Building jar: D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\target\demo1-maven-plugin-run-1.0-SNAPSHOT.jar
[INFO]
[INFO] — maven-shade-plugin:3.2.1:shade (default) @ demo1-maven-plugin-run —
[INFO] Replacing original artifact with shaded artifact.
[INFO] Replacing D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\target\demo1-maven-plugin-run-1.0-SNAPSHOT.jar with D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\target\demo1-maven-plugin-run-1.0-SNAPSHOT-shaded.jar
[INFO]
[INFO] <<< demo1-maven-plugin:1.0-SNAPSHOT:run (default-cli) < package @ demo1-maven-plugin-run <<<
[INFO]
[INFO]
[INFO] — demo1-maven-plugin:1.0-SNAPSHOT:run (default-cli) @ demo1-maven-plugin-run —
[INFO] Started:D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin-run\target\demo1-maven-plugin-run-1.0-SNAPSHOT.jar
Tue Nov 26 17:24:47 CST 2019:0
Tue Nov 26 17:24:48 CST 2019:1
Tue Nov 26 17:24:49 CST 2019:2
Tue Nov 26 17:24:50 CST 2019:3
Tue Nov 26 17:24:51 CST 2019:4
Tue Nov 26 17:24:52 CST 2019:5
Tue Nov 26 17:24:53 CST 2019:6
Tue Nov 26 17:24:54 CST 2019:7
Tue Nov 26 17:24:55 CST 2019:8
Tue Nov 26 17:24:56 CST 2019:9
Tue Nov 26 17:24:57 CST 2019:10
Tue Nov 26 17:24:58 CST 2019:11
Tue Nov 26 17:24:59 CST 2019:12
Tue Nov 26 17:25:00 CST 2019:13
是不是打包+运行很简单,一行命令就搞定了。

后面我们需要学的springboot中也是一个maven命令就可以启动springboot项目,这个原理和我们上面的类似,是spring官方他们自己开发了一款maven插件,可以直接运行springboot项目,后面学习springboot的时候,我们会详细介绍。

总结
本文的内容起到一个抛砖引玉的作用,大家如果有兴趣,可以去写很多更好的maven插件玩玩,maven默认提供了很多优秀的插件,大家可以去看他们的源码,借鉴他们的设计思路,开发出自己喜欢的插件使用,有问题的可以加我微信【itsoku】或者留言交流!

maven系列到此已经结束了,10篇如果都能够坚持看完,大家已经成为一等一的高手了。

后面将进行mybatis、springboot、springcloud系列,所有系列的目标都是让大家掌握从入门到高级开发所需要的所有技能。

Maven系列目录
Maven系列:第1篇:Maven未出世前,我们那些痛苦的经历!

Maven系列第2篇:安装、配置、mvn运行过程详解

Maven系列第3篇:详解maven解决依赖问题

Maven系列第4篇:仓库详解

Maven系列第5篇:私服详解

Maven系列第6篇:生命周期和插件详解,高手必备!

Maven系列第7篇:聚合、继承、单继承问题详解,必备技能!

Maven系列第8篇:大型Maven项目,快速按需任意构建,必备神技能!

Maven系列第9篇:多环境构建,作为核心开发,这个玩不转有点说不过去!

更多好文章
java高并发系列(共34篇)

mysql高手系列(共27篇)

聊聊db和缓存一致性常见的实现方式

接口幂等性这么重要,它是什么?怎么实现?
————————————————
版权声明:本文为CSDN博主「路人甲Java」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/likun557/article/details/103268188

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值