Advertisement

Maven笔记 - 第十章

阅读量:

第10篇:自定义插件,maven的生命交给你来设计!

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

这是maven系列第10篇。

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

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

必备知识

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

本篇环境

jdk1.8

maven3.6.2

idea

本章内容

自定义插件详细步骤

自定义插件参数的使用

自定义插件前缀的使用

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

自定义插件详细步骤

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

复制代码
    org.apache.maven.plugin.Mojo

接口有3个方法:

复制代码
    void execute()  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接口中的setLoggetLog实现了,而execute方法没有实现,交给继承者去实现,这个类中Log默认可以向控制台输出日志信息,maven中自带的插件都继承这个类,一般情况下我们开发插件目标可以直接继承这个类,然后实现execute方法就可以了。

实现一个插件的具体步骤

1、 创建一个maven构件,这个构件的packaging比较特殊,必须为maven-plugin,表示这个构件是一个插件类型,如下:

pom.xml中的packageing元素必须如下值:

复制代码
    <packaging>maven-plugin</packaging>
2、导入maven插件依赖:
复制代码
    <dependency>
    <groupId>org.apache.maven</groupId>
    <artifactId>maven-plugin-api</artifactId>
    <version>3.0</version>
    </dependency>
    
    <dependency>
    <groupId>org.apache.maven.plugin-tools</groupId>
    <artifactId>maven-plugin-annotations</artifactId>
    <version>3.4</version>
    <scope>provided</scope>
    </dependency>
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

下面我们来实现我们第一个插件,插件构件信息:

复制代码
    <groupId>com.javacode2018</groupId>
    <artifactId>demo1-maven-plugin</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>maven-plugin</packaging>

创建一个目标类demo1,调用这个目标的时候,希望他能够输出:

复制代码
    hello my first maven plugin!
创建一个maven项目

打开idea,点击File->New->Project,如下图:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-j7QGWVgu-1629908740221)(media/40b81c016bc4695b99669f13d4af01fc.png)]

选择Maven,如下图:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kpWEPsmt-1629908740225)(media/29baa68faa1523b9e69503e0d4215eaa.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vfb9FhRG-1629908740229)(media/225faaebb3a428977aa17855f14fe700.png)]

点击上图中的Next,如下图,输入Project namemaven-chat10

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Rwq9IZ8l-1629908740233)(media/6c8782fcc498d677fc7b9abfd95f95b6.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-nWmbgDMQ-1629908740236)(media/ad5ab3b6a563560a390f7d13a0c5701d.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JycBnj6d-1629908740240)(media/31e6ec12f10e0a9ca95e121685f815ae.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-RALiKTwP-1629908740245)(media/68c1daa77d794421891803b7f6d1fc30.png)]

创建插件模块demo1-maven-plugin

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

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

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-LPebFzeb-1629908740249)(media/b7e6a8a3a532b21d3b1cb6856b94edd3.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fcB9ZJuO-1629908740253)(media/e43fc5acb27a2e9bb8cd266ea932f278.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ECEuxh1M-1629908740255)(media/3ce9a3acab62ae38614b19baeadadec5.png)]

点击+,如下图:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-eXVb49zy-1629908740257)(media/a0c7b7e5e99236811db416695282bb32.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-63PKsU2y-1629908740259)(media/2f70ab7d2efa05b81336a598b8ae4b51.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-quJJ27Gh-1629908740261)(media/c8b78f9c86e120b9721e2dcba3fa7606.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-zeWuodqE-1629908740262)(media/b2e32be73edd42d4f5dee01a33106027.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Risad6pj-1629908740264)(media/41d93688bbdd89f5442c1a371f7e576a.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-yuth0uAC-1629908740266)(media/fc26e489460f14ff620e5e870a3073e8.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kprvWmuW-1629908740267)(media/9dbcf35404f710a23c7cc117ff28f504.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-EiLpxwOm-1629908740269)(media/2311f90a15ae166c019a05fb72ed84f6.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-RrSaXjh1-1629908740270)(media/879707742287a5d4dfa8c72d25356073.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-jgg6t8bL-1629908740272)(media/eb247b603eee61f8595d53770405c01f.png)]

修改上图中Module namedemo1-maven-plugin,如下图:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-BQYFhk4B-1629908740273)(media/9232592562dfd46319347e713a1e5ea0.png)]

点击上图的Finish,如下图:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ZmWOh5aY-1629908740274)(media/777d3f4b80daea8a8093d213e9b69056.png)]

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Mm41mWs0-1629908740276)(media/57ea1926e393f42d111656298fe32704.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sV5z5EbH-1629908740278)(media/001c0955f125c404dde6288ba70e092a.png)]

设置demo1-maven-plugin/pom.xmlpackaging的值为maven-plugin,如下
复制代码
    <packaging>maven-plugin</packaging>
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内容如下

复制代码
     version="1.0" encoding="UTF-8"
     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/xsd/maven-4.0.0.xsd"
    4.0.0
    
    com.javacode2018
    demo1-maven-plugin
    1.0-SNAPSHOT
    
    maven-plugin
    
    
        UTF-8
        
        1.8
        
        1.8
        
        1.8
    
    
    
        
        
            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注解,如下:

复制代码
     com.javacode2018;
    
     org.apache.maven.plugin.AbstractMojo;
     org.apache.maven.plugin.MojoExecutionException;
     org.apache.maven.plugin.MojoFailureException;
     org.apache.maven.plugins.annotations.Mojo;
    
    
      工作1、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:马士兵老师
     
    @Mojo(name = "demo1")
      Demo1Mojo  AbstractMojo {
     void execute()  MojoExecutionException, MojoFailureException {
    }
    }

注意上面注解@Mojo(name = "demo1")name使用来标注目标的名称为demo1

实现目标类的execute方法

我们在execute方法中输出一句话

复制代码
    .getLog().info("hello my first maven plugin!");

目前execute方法代码如下:

复制代码
     void execute()  MojoExecutionException, MojoFailureException {
    .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  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 (-clean) @ demo1-maven-plugin ---
    [INFO] Deleting D:\code\IdeaProjects\maven-chat10\demo1-maven-plugin\target
    [INFO]
    [INFO] --- maven-resources-plugin:2.6:resources (-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 (-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 (-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 (-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 (-testCompile) @ demo1-maven-plugin ---
    [INFO] Nothing to compile - all classes are up to date
    [INFO]
    [INFO] --- maven-surefire-plugin:2.12.4:test (-test) @ demo1-maven-plugin ---
    [INFO] No tests to run.
    [INFO]
    [INFO] --- maven-jar-plugin:2.4:jar (-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 (-addPluginArtifactMetadata) @ demo1-maven-plugin ---
    [INFO]
    [INFO] --- maven-install-plugin:2.4:install (-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  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 (-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 (-cli) @ maven-chat10 ---
    [INFO] hello my first maven plugin!
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Summary  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!" )
     String greeting;

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

在pom.xml配置参数的值

复制代码
      com.javacode2018
      demo1-maven-plugin
0-SNAPSHOT
      
    欢迎您和【马士兵老师】一起学习Maven技术!</greeting>

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

Boolean参数

复制代码
     My boolean
    
    @Parameter
     boolean myBoolean;
    true

数字类型参数

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

复制代码
     My Integer
    
    @Parameter
     Integer myInteger;
    10

File类型参数

读取配置时,XML文件中的文本用作所需文件或目录的路径。如果路径是相对的(不是以/或C:之类的驱动器号开头),则路径是相对于包含POM的目录的。例子:

复制代码
     My File
    
    @Parameter
     File myFile;
    c:\temp

枚举类型参数

复制代码
      Color {
      GREEN,
      RED,
      BLUE
    }
    
    
     My Enum
    
    @Parameter
     Color myColor;
    GREEN

数组类型参数

复制代码
     My Array
    
    @Parameter
     String[] myArray;
    
      value1
      value2

Collections类型参数

复制代码
     My List
    
    @Parameter
     List myList;
    
      value1
      value2

Maps类型参数

复制代码
     My Map
    
    @Parameter
     Map myMap;
    
      value1
      value2

Properties类型参数

java.util.Properties的类型

复制代码
     My Properties
    
    @Parameter
     Properties myProperties;
    
      
    propertyName1
    propertyValue1
      
      
    propertyName2
    propertyValue2

自定义类型参数

复制代码
     My Object
    
    @Parameter
     MyObject myObject;
    
      test

案例2

修改案例代码

我们将上面各种类型的参数都放到Demo1Mojo中,Demo1Mojo类如下:

复制代码
     com.javacode2018;
    
     org.apache.maven.plugin.AbstractMojo;
     org.apache.maven.plugin.MojoExecutionException;
     org.apache.maven.plugin.MojoFailureException;
     org.apache.maven.plugins.annotations.Mojo;
     org.apache.maven.plugins.annotations.Parameter;
    
     java.io.File;
     java.lang.reflect.Field;
     java.util.Arrays;
     java.util.List;
     java.util.Map;
     java.util.Properties;
    
    
      工作1、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:马士兵老师
     
    @Mojo(name = "demo1")
      Demo1Mojo  AbstractMojo {
    
    
      要显示的问候语。
     
    @Parameter(property = "sayhi.greeting", defaultValue = "Hello World!")
     String greeting;
    
    
      My boolean
     
    @Parameter
     boolean myBoolean;
    
    
      My Integer
     
    @Parameter
     Integer myInteger;
    
    
      My File
     
    @Parameter
     File myFile;
    
      Color {
        GREEN,
        RED,
        BLUE
    }
    
    
      My Enum
     
    @Parameter
     Color myColor;
    
    
      My Array
     
    @Parameter
     String[] myArray;
    
    
      My List
     
    @Parameter
     List myList;
    
    
      My Map
     
    @Parameter
     Map myMap;
    
    
      My Properties
     
    @Parameter
     Properties myProperties;
    
     static  Person {
         String name;
         int age;
    
         String getName() {
             name;
        }
    
         void setName(String name) {
            .name = name;
        }
    
         int getAge() {
             age;
        }
    
         void setAge(int age) {
            .age = age;
        }
    
        @Override
         String toString() {
             "Person{" +
                    "name='" + name + '\'' +
                    ", age=" + age +
                    '}';
        }
    }
    
    @Parameter
     Person person;
    
     void execute()  MojoExecutionException, MojoFailureException {
        .getLog().info("hello my first maven plugin!");
    
        Field[] declaredFields = Demo1Mojo.class.getDeclaredFields();
    
        Arrays.stream(declaredFields).forEach(f -> {
             (f.isAccessible()) {
                f.setAccessible();
            }
             {
                .getLog().info(f.getName() + ":" + f.get());
            }  (IllegalAccessException e) {
                .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过程类似,可以直接参考,创建好了,如下:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sHOpDZgZ-1629908740282)(media/edb9a2565e73f9d1a408d2dc67fc6293.png)]

修改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
                        
                        
                            马士兵老师
                            30
                        
                        
                            
                                name
                                javacode2018
                            
                            
                                age
                                30
                            
                        
                        
                            马士兵老师
                            32

上面是将生命周期的pre-clean阶段绑定插件demo1-maven-plugindemo1目标,并且设置了demo1目标所需要的所有参数的值。

验证效果

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

复制代码
    D:\code\IdeaProjects\maven-chat10>mvn pre-clean -pl :demo1-maven-plugin-test -Dsayhi.greeting="欢迎和【马士兵老师】一起学习Maven!"
    [INFO] Scanning  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:欢迎和【马士兵老师】一起学习Maven!
    [INFO] myBoolean:
    [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=马士兵老师}
    [INFO] myProperties:{age=30, name=javacode2018}
    [INFO] person:Person{name='马士兵老师', 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,他的groupIdorg.apache.maven.plugins,所以能够直接找到。

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

~/.m2/settings.xml中配置自定义插件组

pluginGroups中加入自定义的插件组groupId,如:

复制代码
    com.javacode2018

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

使用插件前缀调用插件
复制代码
    mvn 插件前缀:插件目标

案例3

~/.m2/settings.xml中加入下面配置:

复制代码
    <pluginGroup>com.javacode2018</pluginGroup>

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  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 (-cli) @ demo1-maven-plugin-test ---
    [INFO] hello my first maven plugin!
    [INFO] greeting:Hello World!
    [INFO] myBoolean:
    [INFO] myInteger:
    [INFO] myFile:
    [INFO] myColor:
    [INFO] myArray:
    [INFO] myList:
    [INFO] myMap:
    [INFO] myProperties:
    [INFO] person:
    [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
            
            
                
                     implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"
                        启动类完整路径</mainClass>

上面使用到了maven官方提供的一个打包的插件,可以将构件打包为可以直接运行的jar包。

2、自定义一个插件,然后执行上面打包好的插件

插件中需要通过java命令调用打包好的jar包,然后运行。

具体实现如下

创建自定义目标类

demo1-maven-plugin中创建一个插件目标类,如下:

复制代码
     com.javacode2018;
    
     org.apache.maven.plugin.AbstractMojo;
     org.apache.maven.plugin.MojoExecutionException;
     org.apache.maven.plugin.MojoFailureException;
     org.apache.maven.plugins.annotations.Execute;
     org.apache.maven.plugins.annotations.LifecyclePhase;
     org.apache.maven.plugins.annotations.Mojo;
     org.apache.maven.plugins.annotations.Parameter;
    
     java.io.BufferedReader;
     java.io.IOException;
     java.io.InputStreamReader;
    
    
      工作1、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:马士兵老师
     
    @Mojo(name = "run", defaultPhase = LifecyclePhase.PACKAGE)
    @Execute(phase = LifecyclePhase.PACKAGE)
      RunMojo  AbstractMojo {
    
    
      打包好的构件的路径
     
    @Parameter(defaultValue = "${project.build.directory}\ ${project.artifactId}-${project.version}.jar")
     String jarPath;
    
    @Override
     void execute()  MojoExecutionException, MojoFailureException {
         {
            .getLog().info("Started:" + .jarPath);
            ProcessBuilder builder =  ProcessBuilder("java", "-jar", .jarPath);
            final Process process = builder.start();
    
             Thread(() -> {
                BufferedReader reader =  BufferedReader( InputStreamReader(process.getInputStream()));
                 {
                    String s;
                     ((s = reader.readLine()) != ) {
                        System.out.println(s);
                    }
                }  (IOException e) {
                    e.printStackTrace();
                }
            }).start();
            Runtime.getRuntime().addShutdownHook( Thread() {
                @Override
                 void run() {
                    RunMojo.this.getLog().info("Destroying...");
                    process.destroy();
                    RunMojo.this.getLog().info("Shutdown hook finished.");
                }
            });
    
            process.waitFor();
            .getLog().info("Finished.");
        }  (Exception e) {
            .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过程类似,可以直接参考,创建好了,如下:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-GVExJbmU-1629908740285)(media/93f853548bb2ce5b7caac093e722bc4b.png)]

创建com.javacode2018.Demo

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

复制代码
     com.javacode2018;
    
     java.util.Calendar;
     java.util.concurrent.TimeUnit;
    
    
      工作1、算法、数据库方面的技术干货!坚信用技术改变命运,让家人过上更体面的生活!喜欢的请关注公众号:马士兵老师
     
      Demo1 {
     static void main(String[] args)  InterruptedException {
         (int i = 0; i < 1000; i++) {
            System.out.println(Calendar.getInstance().getTime() + ":" + i);
            TimeUnit.SECONDS.sleep(1);
        }
    }
    }
修改demo1-maven-plugin-run/pom.xml,如下
复制代码
     version="1.0" encoding="UTF-8"
     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/xsd/maven-4.0.0.xsd"
    4.0.0
    
    com.javacode2018
    demo1-maven-plugin-run
    1.0-SNAPSHOT
    
    
        UTF-8
        
        1.8
        
        1.8
        
        1.8
    
    
    
        
            
                org.apache.maven.plugins
                maven-shade-plugin
                3.2.1
                
                    
                        package
                        
                            shade
                        
                        
                            
                                 implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"
                                    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  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 (-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 (-cli) >  @ demo1-maven-plugin-run >>>
    [INFO]
    [INFO] --- maven-resources-plugin:2.6:resources (-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 (-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 (-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 (-testCompile) @ demo1-maven-plugin-run ---
    [INFO] Nothing to compile - all classes are up to date
    [INFO]
    [INFO] --- maven-surefire-plugin:2.12.4:test (-test) @ demo1-maven-plugin-run ---
    [INFO] No tests to run.
    [INFO]
    [INFO] --- maven-jar-plugin:2.4:jar (-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 () @ 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 (-cli) <  @ demo1-maven-plugin-run <<<
    [INFO]
    [INFO]
    [INFO] --- demo1-maven-plugin:1.0-SNAPSHOT:run (-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默认提供了很多优秀的插件,大家可以去看他们的源码,借鉴他们的设计思路,开发出自己喜欢的插件使用

maven系列到此已经结束了,后面将进行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篇:多环境构建,作为核心开发,这个玩不转有点说不过去!
emo1-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默认提供了很多优秀的插件,大家可以去看他们的源码,借鉴他们的设计思路,开发出自己喜欢的插件使用** **maven系列到此已经结束了,后面将进行mybatis、springboot、springcloud系列,所有系列的目标都是让大家掌握从入门到高级开发所需要的所有技能。**
    
    ## Maven系列目录
    
    1.  Maven系列:第1篇:Maven未出世前,我们那些痛苦的经历!
    
    2.  Maven系列第2篇:安装、配置、mvn运行过程详解
    
    3.  Maven系列第3篇:详解maven解决依赖问题
    
    4.  Maven系列第4篇:仓库详解
    
    5.  Maven系列第5篇:私服详解
    
    6.  Maven系列第6篇:生命周期和插件详解,高手必备!
    
    7.  Maven系列第7篇:聚合、继承、单继承问题详解,必备技能!
    
    8.  Maven系列第8篇:大型Maven项目,快速按需任意构建,必备神技能!
    
    9.  Maven系列第9篇:多环境构建,作为核心开发,这个玩不转有点说不过去!

全部评论 (0)

还没有任何评论哟~