Maven 作為一個(gè)優(yōu)秀的項(xiàng)目管理工具，其插件機(jī)制為其功能擴(kuò)展提供了非常大的便捷性。

雖然說(shuō)大多數(shù)情況下，我們可能不太會(huì)自己去編寫(xiě) Maven 插件，但不排除在某些特殊的情況下，我們需要去完成一個(gè)自己的插件，來(lái)協(xié)助我們處理某些比較通用的事情。

正好，最近有一些需求可能需要對(duì) Drools 的一個(gè) Maven 插件進(jìn)行擴(kuò)展，所以學(xué)習(xí)一下 Maven 的插件編寫(xiě)。

Maven 插件的命名規(guī)范

一般來(lái)說(shuō)，我們會(huì)將自己的插件命名為 -maven-plugin，而不推薦使用 maven--plugin，因?yàn)楹笳呤?Maven 團(tuán)隊(duì)維護(hù)官方插件的保留命名方式，使用這個(gè)命名方式會(huì)侵犯 Apache Maven 商標(biāo)。

什么是 Mojo？

Mojo 就是 Maven plain Old Java Object。每一個(gè) Mojo 就是 Maven 中的一個(gè)執(zhí)行目標(biāo)（executable goal），而插件則是對(duì)單個(gè)或多個(gè)相關(guān)的 Mojo 做統(tǒng)一分發(fā)。一個(gè) Mojo 包含一個(gè)簡(jiǎn)單的 Java 類。插件中多個(gè)類似 Mojo 的通用之處可以使用抽象父類來(lái)封裝。

創(chuàng)建 Mojo 工程

這里，我們使用 Idea 作為開(kāi)發(fā)工具進(jìn)行講解，創(chuàng)建工程選擇 Maven，然后在模板中找到 maven-archetype-mojo，點(diǎn)擊下一步，輸入對(duì)應(yīng)的參數(shù)，如：com.qchery/ekjar-maven-plugin/1.0-SNAPSHOT，最后點(diǎn)擊完成即可創(chuàng)建一個(gè)簡(jiǎn)單的 Mojo 工程。

Maven 插件的命名規(guī)范

一般來(lái)說(shuō)，我們會(huì)將自己的插件命名為 -maven-plugin，而不推薦使用 maven--plugin，因?yàn)楹笳呤?Maven 團(tuán)隊(duì)維護(hù)官方插件的保留命名方式，使用這個(gè)命名方式會(huì)侵犯 Apache Maven 商標(biāo)。

什么是 Mojo？

Mojo 就是 Maven plain Old Java Object。每一個(gè) Mojo 就是 Maven 中的一個(gè)執(zhí)行目標(biāo)（executable goal），而插件則是對(duì)單個(gè)或多個(gè)相關(guān)的 Mojo 做統(tǒng)一分發(fā)。一個(gè) Mojo 包含一個(gè)簡(jiǎn)單的 Java 類。插件中多個(gè)類似 Mojo 的通用之處可以使用抽象父類來(lái)封裝。

創(chuàng)建 Mojo 工程

這里，我們使用 Idea 作為開(kāi)發(fā)工具進(jìn)行講解，創(chuàng)建工程選擇 Maven，然后在模板中找到 maven-archetype-mojo，點(diǎn)擊下一步，輸入對(duì)應(yīng)的參數(shù)，如：com.qchery/ekjar-maven-plugin/1.0-SNAPSHOT，最后點(diǎn)擊完成即可創(chuàng)建一個(gè)簡(jiǎn)單的 Mojo 工程。

創(chuàng)建完成后，工程內(nèi)會(huì)生成對(duì)應(yīng)的 pom.xml 文件。其內(nèi)容比較簡(jiǎn)單，與普通 Maven 工程的 pom.xml 基本一致，只是自動(dòng)添加了對(duì) maven-plugin-api 的依賴，這個(gè)依賴?yán)锩鏁?huì)包含一些 Mojo 的接口與抽象類，在后續(xù)編寫(xiě)具體的 Mojo 時(shí)再進(jìn)行詳細(xì)講解。

<dependency>
? <groupId>org.apache.maven</groupId>
? <artifactId>maven-plugin-api</artifactId>
? <version>2.0</version>
</dependency>

與普通 pom.xml 文件一個(gè)重要的不同之處是它的打包方式：

<packaging>maven-plugin</packaging>

簡(jiǎn)單 Mojo 的創(chuàng)建

工程創(chuàng)建完畢后，我們開(kāi)始 Mojo 創(chuàng)建之旅，上面提到過(guò) Mojo 是一個(gè)簡(jiǎn)單的 Java 類，那我們創(chuàng)建第一個(gè) Mojo 類用于打印一行輸出。

import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
/**
?* @goal hello
?*/
public class HelloMojo extends AbstractMojo {
? ? public void execute() throws MojoExecutionException, MojoFailureException {
? ? ? ? System.out.println("hello world");
? ? }
}

觀察一下這個(gè)類，我們發(fā)現(xiàn)它繼承了 AbstractMojo 這個(gè)抽象類，并實(shí)現(xiàn)了 execute() 方法，該方法就是用來(lái)定義這個(gè) Mojo 具體操作內(nèi)容，我們只需要根據(jù)自己的需要來(lái)編寫(xiě)自己的實(shí)現(xiàn)即可。

Mojo 操作的實(shí)現(xiàn)我們了解了，那怎么讓 Maven 知道這是一個(gè) Mojo 而不是一個(gè)普通的 Java 類呢？這里，就需要說(shuō)一下 Mojo 的查找機(jī)制了，在處理源碼的時(shí)候，plugin-tools 會(huì)把使用了 @Mojo 注解或 Javadoc 里包含 @goal 注釋的類來(lái)當(dāng)作一個(gè) Mojo 類。在上面的例子中，我們使用了 Javadoc 的方法來(lái)聲明一個(gè) Mojo。同樣我們也可以使用 @Mojo 注解來(lái)進(jìn)行聲明：

@Mojo(name = "hello")
public class HelloMojo extends AbstractMojo {
? ? public void execute() throws MojoExecutionException, MojoFailureException {
? ? ? ? System.out.println("hello world");
? ? }
}

使用 @Mojo 注解，我們需要引入一個(gè)新包：

<dependency>
? <groupId>org.apache.maven.plugin-tools</groupId>
? <artifactId>maven-plugin-annotations</artifactId>
? <version>3.1</version>
</dependency>

運(yùn)行自定義 Plugin

與使用其它插件類似，我們需要在 pom.xml 文件中引入插件：

<build>
? ? <plugins>
? ? ? ? <plugin>
? ? ? ? ? ? <groupId>com.qchery</groupId>
? ? ? ? ? ? <artifactId>ekjar-maven-plugin</artifactId>
? ? ? ? ? ? <version>1.0-SNAPSHOT</version>
? ? ? ? </plugin>
? ? </plugins>
</build>

先執(zhí)行命令：

mvn install

然后執(zhí)行:

mvn com.qchery:ekjar-maven-plugin:1.0-SNAPSHOT:hello

即可看到輸出：

[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building ekjar-maven-plugin Maven Mojo 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] --- ekjar-maven-plugin:1.0-SNAPSHOT:hello (default-cli) @ ekjar-maven-plugin ---
hello world
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.249 s
[INFO] Finished at: 2017-03-26T12:59:47+08:00
[INFO] Final Memory: 6M/123M
[INFO] ------------------------------------------------------------------------

縮短執(zhí)行命令

在剛才運(yùn)行插件的時(shí)候，我們使用全量的插件指引，但這個(gè)實(shí)在是太長(zhǎng)太繁瑣了，那我們是否可以縮短我們的執(zhí)行命令呢？

答案肯定是可以的，如果你想要執(zhí)行的是你本地庫(kù)中最新版本的插件，那么你可以刪除掉版本號(hào)；如果你的命名滿足前面提及的兩種命令方式，你可以直接使用插件名及 goal 名來(lái)運(yùn)行對(duì)應(yīng)的插件，如：

mvn ekjar:hello

你會(huì)得到與之前完全一樣的結(jié)果。

綁定 Maven 執(zhí)行周期

你還可以將插件配置為將特定目標(biāo)，從而附加到構(gòu)建生命周期中的某個(gè)特定階段。如：

<build>
? ? <plugins>
? ? ? ? <plugin>
? ? ? ? ? ? <groupId>com.qchery</groupId>
? ? ? ? ? ? <artifactId>ekjar-maven-plugin</artifactId>
? ? ? ? ? ? <version>1.0-SNAPSHOT</version>
? ? ? ? ? ? <executions>
? ? ? ? ? ? ? ? <execution>
? ? ? ? ? ? ? ? ? ? <goals>
? ? ? ? ? ? ? ? ? ? ? ? <goal>hello</goal>
? ? ? ? ? ? ? ? ? ? </goals>
? ? ? ? ? ? ? ? ? ? <phase>package</phase>
? ? ? ? ? ? ? ? </execution>
? ? ? ? ? ? </executions>
? ? ? ? </plugin>
? ? </plugins>
</build>

繼承AbstractMojo 的類中，參數(shù)可以通過(guò)命令賦值，例如：

/**
?*
?* @goal echo
?* @phase process-sources
?*/
public class MyMojo extends AbstractMojo {
? ? /**
? ? ?* @parameter expression="${echo.message}" default-value="Hello World..."
? ? ?*/
? ? private String message;
? ? public void execute() throws MojoExecutionException, MojoFailureException {
? ? ? ? System.out.println("hello world");
? ? ? ? getLog().info("hello mymojo : "+message);
? ? }
}

其中注釋就是maven插件很重要的元數(shù)據(jù)

/**
?* @goal CustomMavenMojo：表示該插件的服務(wù)目標(biāo)
?* @phase compile：表示該插件的生效周期階段
?* @requiresProject false：表示是否依托于一個(gè)項(xiàng)目才能運(yùn)行該插件
?* @parameter expression="${name}"：表示插件參數(shù)，使用插件的時(shí)候會(huì)用得到
?* @required:代表該參數(shù)不能省略
?*/

執(zhí)行：

mvn com.handarui.yanquan:yanquan:1.0-SNAPSHOT:echo -Decho.message="The Eagle has Landed"

（MyMojo類中的message 參數(shù)的javadoc注釋是 echo.message, 通過(guò)命令賦值時(shí)，需要傳入-Decho.message=XXX 這種形式 ）

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論