[[375589]]

老鐵昨天下午問我什么時候講講Maven插件：

于是老田搞到大半夜終于寫了一篇maven的插件，今天分享給大家。

Maven 是一個執(zhí)行插件的框架，每一個任務實際上是由插件完成的。那么我們今天就來聊聊Maven插件。

什么是Maven插件?

Maven 實際上只是Maven插件集合的核心框架。換句話說，插件是執(zhí)行大部分實際操作的地方。

插件用于：

• 創(chuàng)建jar文件，
• 創(chuàng)建war文件，
• 編譯代碼，
• 單元測試代碼，
• 創(chuàng)建項目文檔等。

插件是Maven的核心功能，它允許在多個項目中重用通用的構建邏輯。他們通過在項目描述(項目對象模型(POM))的上下文中執(zhí)行“操作”(即創(chuàng)建WAR文件或編譯單元測試)來實現(xiàn)此目的。可以通過一組唯一的參數(shù)來自定義插件的行為，這些參數(shù)通過每個插件目標(或Mojo)的描述公開。

一個插件通常提供了一組目標，可使用以下語法來執(zhí)行：

mvn [plugin-name]:[goal-name] 

例如：一個 Java 項目可以使用 Maven 編譯器插件來編譯目標，通過運行以下命令編譯

mvn compiler:compile 

插件有哪些類型

Maven 提供以下兩種類型插件：

以下是一些常見的插件列表：

例如

我們使用 maven-antrun-plugin 插件在例子中來在控制臺打印數(shù)據(jù)。現(xiàn)在在 C:\MVN\project 文件夾 創(chuàng)建一個 pom.xml 文件，內(nèi)容如下:

<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>com.companyname.projectgroup</groupId> 
<artifactId>project</artifactId> 
<version>1.0</version> 
<build> 
<plugins> 
   <plugin> 
   <groupId>org.apache.maven.plugins</groupId> 
   <artifactId>maven-antrun-plugin</artifactId> 
   <version>1.1</version> 
   <executions> 
      <execution> 
         <id>id.clean</id> 
         <phase>clean</phase> 
         <goals> 
            <goal>run</goal> 
         </goals> 
         <configuration> 
            <tasks> 
               <echo>clean phase</echo> 
            </tasks> 
         </configuration> 
      </execution>      
   </executions> 
   </plugin> 
</plugins> 
</build> 
</project> 

接下來，打開命令終端跳轉(zhuǎn)到 pom.xml 所在的目錄，并執(zhí)行下面的 mvn 命令。

mvn clean 

Maven 將開始處理并顯示 clean 生命周期的 clean 階段。

[INFO] Scanning for projects... 
[INFO] ------------------------------------------------------------------ 
[INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0 
[INFO]    task-segment: [post-clean] 
[INFO] ------------------------------------------------------------------ 
[INFO] [clean:clean {execution: default-clean}] 
[INFO] [antrun:run {execution: id.clean}] 
[INFO] Executing tasks [echo] clean phase 
[INFO] Executed tasks 
[INFO] ------------------------------------------------------------------ 
[INFO] BUILD SUCCESSFUL 
[INFO] ------------------------------------------------------------------ 
[INFO] Total time: < 1 second 
[INFO] Finished at: Sat Jul 07 13:38:59 IST 2020 
[INFO] Final Memory: 4M/44M 
[INFO] -------- 

上面的例子展示了以下關鍵概念：

• 插件是在 pom.xml 中使用 plugins 元素定義的。
• 每個插件可以有多個目標。
• 你可以定義階段，插件會使用它的 phase 元素開始處理。我們已經(jīng)使用了 clean 階段。
• 你可以通過綁定到插件的目標的方式來配置要執(zhí)行的任務。我們已經(jīng)綁定了 echo 任務到 maven-antrun-plugin 的 run 目標。
• 就是這樣，Maven 將處理剩下的事情。它將下載本地倉庫中獲取不到的插件，并開始處理。

插件與目標

一個插件通常可以完成多個任務，每一個任務就叫做插件的一個目標。如執(zhí)行mvn install命令時，調(diào)用的插件和執(zhí)行的插件目標如下 ：

將插件綁定到生命周期

Maven的生命周期是抽象的，實際需要插件來完成任務，這一過程是通過將插件的目標(goal)綁定到生命周期的具體階段(phase)來完成的。如：將maven-compiler-plugin插件的compile目標綁定到default生命周期的compile階段，完成項目的源代碼編譯：

內(nèi)置綁定

Maven對一些生命周期的階段(phase)默認綁定了插件目標，因為不同的項目有jar、war、pom等不同的打包方式，因此對應的有不同的綁定關系，其中針對default生命周期的jar包打包方式的綁定關系如下：

在第二列中，冒號前面是插件的前綴(prefix)，是配置和使用插件的一種簡化方式;冒號后面即是綁定的插件目標。

你的倉庫中有哪些maven插件?

存放目錄=%本地倉庫%\org\apache\maven\plugins 

Maven官網(wǎng)上有更詳細的官方插件列表：

自定義插件

在前面我們提到了一個Mojo，Mojo實際上是一個Maven的目標，插件包含任意數(shù)量的目標(Mojos)。Mojos可以定義為帶注釋的java類或Beanshell腳本。Mojo指定有關目標的元數(shù)據(jù)：目標名稱，它適合生命周期的哪個階段，以及它期望的參數(shù)。

Mojo術語是在maven2中引入，它是對如何編寫插件的完整重寫。Mojo是對Pojo(plain-old-java-object)的一種改進，它將maven替換為plain。

一個 Mojo 包含一個簡單的 Java 類。插件中多個類似 Mojo 的通用之處可以使用抽象父類來封裝。Maven插件項目的打包方式packaging必須為maven-plugin。

實現(xiàn)自定義插件

創(chuàng)建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>com.tian.maven</groupId> 
    <artifactId>my-maven-plugin</artifactId> 
    <packaging>maven-plugin</packaging> 
    <version>1.0-SNAPSHOT</version> 
    <name>my-maven-plugin</name> 
    <url>http://maven.apache.org</url> 
    <dependencies> 
        <dependency> 
            <groupId>junit</groupId> 
            <artifactId>junit</artifactId> 
            <version>3.8.1</version> 
            <scope>test</scope> 
        </dependency> 
        <!--api依賴--> 
        <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> 
    </dependencies> 
</project> 

TianMojo繼承了 AbstractMojo 這個抽象類，并實現(xiàn)了 execute() 方法，該方法就是用來定義這個 Mojo 具體操作內(nèi)容，我們只需要根據(jù)自己的需要來編寫自己的實現(xiàn)即可。

//自定義插件類 
//name就是后面使用該插件的時候excuation里面的 
@Mojo(name = "tian") 
public class TianMojo extends AbstractMojo 
{ 
    // 配置的是本maven插件的配置，在pom使用configration標簽進行配置 property就是名字， 
    // 在配置里面的標簽名字。在調(diào)用該插件的時候會看到，還可以設置默認值 
    @Parameter(property = "userName",defaultValue = "田哥你好") 
    private String userName; 
    @Parameter(property = "pwd",defaultValue = "000000") 
    private String pwd; 
 
    @Override 
    public void execute() throws MojoExecutionException, MojoFailureException { 
        System.out.println("userm=" + userName + " pwd=" + pwd); 
        System.out.println("my plugin is running"); 
    } 
} 

然后在執(zhí)行mvn clean install命令。

使用自定義插件

在我們的maven項目添加我們自定義的插件：

<build> 
    <plugins> 
      <plugin> 
        <groupId>com.tian.maven</groupId> 
        <artifactId>my-maven-plugin</artifactId> 
        <version>1.0-SNAPSHOT</version> 
        <executions> 
          <execution> 
            <!-- 表示我們在執(zhí)行mvn install時候就會執(zhí)行我們自定義的插件tian-->   
            <phase>install</phase> 
            <goals> 
              <!-- 目標 --> 
              <goal>tian</goal> 
            </goals> 
          </execution> 
        </executions> 
        <!-- 我們自定義的Mojo中定義的屬性 --> 
        <configuration> 
          <userName>田維常</userName> 
          <pwd>123456</pwd> 
        </configuration> 
      </plugin> 
    </plugins> 
</build> 

然后就可以在我們的IDEA中看到：

雙擊my:tian：

還可以使用命令的方式：mvn my:tian

my是前綴，是my-maven的縮寫。后綴tian就是插件綁定的目標。

到此，我們的自定義Maven插件就搞定了。

總結

Maven插件是Maven的核心功能，插件類型有構建類型和報告類型，插件可以有多個目標也就是可以理解為多個功能。自定義插件主要兩步：依賴相關jar包和重寫Mojo。自定義的插件的使用和我們用其他插件使用一樣，只要在pom中配置相關配置即可。

只有真正理解了插件實現(xiàn)原理后，才能慢慢去體會猜測我們平時使用的那些mvn...命令背后是如何實現(xiàn)的。

本文轉(zhuǎn)載自微信公眾號「Java后端技術全棧」，可以通過以下二維碼關注。轉(zhuǎn)載本文請聯(lián)系Java后端技術全棧公眾號。