手撸一款属于自己的Maven插件,说干就干!!

简介: 手撸一款属于自己的Maven插件,说干就干!!

大家好,我是冰河~~

今天,冰河给大家分享一篇大部分人都不会的技能,那就是我们自己动手写一款属于自己的Maven插件。好了,直接进入今天的主题吧。

Maven插件的相关概念

插件坐标定位

插件与普通jar包一样包含坐标定位属性即:groupId、artifactId、version,当使用该插件时会从本地仓库中搜索,如果没有则从远程仓库下载,例如下面的配置所示。

<!-- 唯一定位到dependency 插件 -->
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.10</version>

execution配置

execution 配置包含一组指示插件如何执行的属性:

  • id :执行器命名
  • phase:标识执行的阶段
  • goals:标识执行的目标或功能
  • configuration:标识执行目标所需的配置文件

插件的配置和使用示例

将插件依赖拷贝到指定目录。

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <version>3.1.1</version>
  <executions>
    <execution>
      <id>copy-dependencies</id>
      <phase>package</phase>
      <goals>
        <goal>copy-dependencies</goal>
      </goals>
      <configuration>       
        <outputDirectory>${project.build.directory}/alternateLocation</outputDirectory>
        <overWriteReleases>false</overWriteReleases>
        <overWriteSnapshots>true</overWriteSnapshots>
        <excludeTransitive>true</excludeTransitive>
      </configuration>
    </execution>
  </executions>
</plugin>

常用插件的使用

通过命令执行插件语法

除了通过配置的方式使用插件以外,Maven也提供了通过命令直接调用插件目标其命令格式如下所示。

mvn groupId:artifactId:version:goal -D{参数名}

通过命令执行插件示例

(2)展示pom的依赖关系树

mvn org.apache.maven.plugins:maven-dependency-plugin:2.10:tree

(3)直接简化版的命令,但前提必须是maven 官方插件

mvn dependency:tree

其它常用插件

(1)查看pom 文件的最终配置

mvn help:effective-pom

(2)原型项目生成

archetype:generate

(3)快速创建一个Web程序

mvn archetype:generate -DgroupId=io.mykit.web -DartifactId=mykit-maven-web -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

(4)快速创建一个Java项目

mvn archetype:generate -DgroupId=io.mykit.java -DartifactId=mykit-maven-java -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

自定义Maven插件

这里,我们先来说说自定义Maven插件的步骤,这里,我将自定义Maven插件的步骤总结如下。

(1)创建maven 插件项目

(2)设定packaging 为maven-plugin

(3)添加插件依赖

(4)编写插件实现逻辑

(5)打包构建插件

接下来,我们就来实现自定义Maven插件。

配置插件项目的pom.xml

这里,我直接跳过了Maven项目的创建,相信小伙伴们都会创建Maven项目,这里,我就不再赘述了,直接给出pom.xml文件的配置,如下所示。

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>io.mykit.plugin</groupId>
    <version>1.0.0-SNAPSHOT</version>
    <artifactId>mykit-maven-plugin</artifactId>
    <packaging>maven-plugin</packaging>
    <dependencies>
        <dependency>
            <groupId>org.apache.maven</groupId>
            <artifactId>maven-plugin-api</artifactId>
            <version>3.5.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.maven.plugin-tools</groupId>
            <artifactId>maven-plugin-annotations</artifactId>
            <version>3.5</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.6.1</version>
                <configuration>
                    <source>1.8 </source>
                    <target>1.8 </target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Maven插件的实现类

接下来,我们来编写Maven插件的实现类。这里,我直接给出类的源代码,如下所示。

package io.mykit.plugin; 
import javafx.beans.DefaultProperty;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.plugins.annotations.LifecyclePhase;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.Parameter;
/**
 * @author binghe
 * @description 自定义Maven插件
 */
@Mojo(name = "binghe")
public class MykitMavenPlugin extends AbstractMojo {
    private final Logger logger = LoggerFactory.getLogger(MykitMavenPlugin.class);
    @Parameter(property="sex")
    String sex;
    @Parameter(property="describe")
    String describe;
    public void execute() throws MojoExecutionException, MojoFailureException {
        logger.info(String.format("binghe sex=%s describe=%s",sex,describe));
    }
}

打包安装插件

将自定义的Maven插件打包并安装到本地Maven仓库,如下所示。

  • 打包
mvn clean package
  • 安装到本地仓库
mvn clean install

其他项目中引用自定义插件

如果需要在其他项目中使用我们自定义的Maven插件,则只需要创建一个Maven项目,在Maven项目的pom.xml文件中引入如下配置即可。

<build>
    <plugins>
        <plugin>
            <!--引入刚刚的插件依赖-->
             <groupId>io.mykit.plugin</groupId>
             <version>1.0.0-SNAPSHOT</version>
             <artifactId>mykit-maven-plugin</artifactId>
            <!-- 这里加入的是相关参数,这些参数必须跟插件实现里面的属性保持一致 -->
            <configuration>
                <sex>男</sex>
                <describe>冰河技术微信公众号作者</describe>
            </configuration>
        </plugin>
    </plugins>
</build>

好了,今天就到这儿吧,我是冰河,我们下期见!!

相关文章
|
8月前
|
Java 应用服务中间件 Apache
Maven程序 tomcat插件安装与web工程启动
Maven程序 tomcat插件安装与web工程启动
91 0
|
2月前
|
缓存 Java Maven
【简单四步教你解决♥十分有效】Maven依赖报错、依赖或插件导入失败的万能解决办法
【简单四步教你解决♥十分有效】Maven依赖报错、依赖或插件导入失败的万能解决办法!在处理Maven项目问题时,首先检查Maven配置是否正确。接着通过“File--Invalidata Caches”清除IDEA缓存并重启。使用Maven命令`mvn dependency:purge-local-repository`和`mvn dependency:resolve`清除本地依赖缓存。最后,在Terminal中输入`mvn clean install`完成构建。
【简单四步教你解决♥十分有效】Maven依赖报错、依赖或插件导入失败的万能解决办法
|
2月前
|
存储 Java Linux
【Maven】——基础入门,插件安装、配置和简单使用,Maven如何设置国内源
Maven插件安装,Maven项目构建,依赖管理,Haven Help插件,Maven仓库,Maven如何设置国内源
|
7月前
|
XML Java Maven
maven总结三: 常用插件
maven总结三: 常用插件
73 3
|
7月前
|
Java 测试技术 Maven
Maven 插件
Maven包含clean、default(build)、site三大生命周期,分别处理项目清理、部署和文档创建。每个生命周期由多个阶段组成,充当标准化接口,实际工作由插件执行。例如,`mvn clean`调用的是clean生命周期的clean阶段,其实现由maven-clean-plugin插件完成。Maven是一个依赖插件的框架,插件负责任务如生成jar/war、编译、测试、文档和报告。通过`mvn plugin-name:goal-name`命令执行插件目标。
|
4月前
|
Java 编译器 测试技术
全面理解Maven Compiler Plugin-Maven编译插件
【10月更文挑战第16天】
790 1
|
6月前
|
Java Maven Spring
Maven重打包问题之maven-shade-plugin插件对于重复的class文件会如何处理
Maven重打包问题之maven-shade-plugin插件对于重复的class文件会如何处理
131 2
|
7月前
|
Java Maven
idea安装并使用maven依赖分析插件:Maven Helper
idea安装并使用maven依赖分析插件:Maven Helper
2844 7
|
6月前
|
Java jenkins 持续交付
jenkins学习笔记之十七:使用插件及maven上传制品到nexus
jenkins学习笔记之十七:使用插件及maven上传制品到nexus
|
7月前
|
数据可视化 Java 程序员
IDEA插件-Maven Helper
Maven Helper是一个用于Apache Maven项目的IntelliJ IDEA插件,它提供了一些有用的功能来帮助开发人员更好地管理和调试Maven项目。
901 0

推荐镜像

更多