[[432395]]

大家好，我是冰河~~

今天，冰河給大家分享一篇大部分人都不會(huì)的技能，那就是我們自己動(dòng)手寫(xiě)一款屬于自己的Maven插件。好了，直接進(jìn)入今天的主題吧。

Maven插件的相關(guān)概念

插件坐標(biāo)定位

插件與普通jar包一樣包含坐標(biāo)定位屬性即：groupId、artifactId、version，當(dāng)使用該插件時(shí)會(huì)從本地倉(cāng)庫(kù)中搜索，如果沒(méi)有則從遠(yuǎn)程倉(cāng)庫(kù)下載，例如下面的配置所示。

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

execution配置

execution 配置包含一組指示插件如何執(zhí)行的屬性：

• id ：執(zhí)行器命名
• phase：標(biāo)識(shí)執(zhí)行的階段
• goals：標(biāo)識(shí)執(zhí)行的目標(biāo)或功能
• configuration：標(biāo)識(shí)執(zhí)行目標(biāo)所需的配置文件

插件的配置和使用示例

將插件依賴拷貝到指定目錄。

<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> 

常用插件的使用

通過(guò)命令執(zhí)行插件語(yǔ)法

除了通過(guò)配置的方式使用插件以外，Maven也提供了通過(guò)命令直接調(diào)用插件目標(biāo)其命令格式如下所示。

mvn groupId:artifactId:version:goal -D{參數(shù)名} 

通過(guò)命令執(zhí)行插件示例

(2)展示pom的依賴關(guān)系樹(shù)

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

(3)直接簡(jiǎn)化版的命令，但前提必須是maven 官方插件

mvn dependency:tree 

其它常用插件

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

mvn help:effective-pom 

(2)原型項(xiàng)目生成

archetype:generate 

(3)快速創(chuàng)建一個(gè)Web程序

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

(4)快速創(chuàng)建一個(gè)Java項(xiàng)目

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

自定義Maven插件

這里，我們先來(lái)說(shuō)說(shuō)自定義Maven插件的步驟，這里，我將自定義Maven插件的步驟總結(jié)如下。

(1)創(chuàng)建maven 插件項(xiàng)目

(2)設(shè)定packaging 為maven-plugin

(3)添加插件依賴

(4)編寫(xiě)插件實(shí)現(xiàn)邏輯

(5)打包構(gòu)建插件

接下來(lái)，我們就來(lái)實(shí)現(xiàn)自定義Maven插件。

配置插件項(xiàng)目的pom.xml

這里，我直接跳過(guò)了Maven項(xiàng)目的創(chuàng)建，相信小伙伴們都會(huì)創(chuàng)建Maven項(xiàng)目，這里，我就不再贅述了，直接給出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插件的實(shí)現(xiàn)類

接下來(lái)，我們來(lái)編寫(xiě)Maven插件的實(shí)現(xiàn)類。這里，我直接給出類的源代碼，如下所示。

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倉(cāng)庫(kù)，如下所示。

• 打包

mvn clean package 

• 安裝到本地倉(cāng)庫(kù)

mvn clean install 

其他項(xiàng)目中引用自定義插件

如果需要在其他項(xiàng)目中使用我們自定義的Maven插件，則只需要?jiǎng)?chuàng)建一個(gè)Maven項(xiàng)目，在Maven項(xiàng)目的pom.xml文件中引入如下配置即可。

<build> 
    <plugins> 
        <plugin> 
            <!--引入剛剛的插件依賴--> 
             <groupId>io.mykit.plugin</groupId> 
             <version>1.0.0-SNAPSHOT</version> 
             <artifactId>mykit-maven-plugin</artifactId> 
            <!-- 這里加入的是相關(guān)參數(shù)，這些參數(shù)必須跟插件實(shí)現(xiàn)里面的屬性保持一致 --> 
            <configuration> 
                <sex>男</sex> 
                <describe>冰河技術(shù)微信公眾號(hào)作者</describe> 
            </configuration> 
        </plugin> 
    </plugins> 
</build> 

好了，今天就到這兒吧，我是冰河，我們下期見(jiàn)!!