【Maven】maven 插件开发实战
【Maven】maven 插件開發實戰
附上我歷時三個月總結的?Java 面試 + Java 后端技術學習指南，這是本人這幾年及春招的總結，目前，已經拿到了大廠offer，拿去不謝！
下載方式
1.?首先掃描下方二維碼
2.?后臺回復「Java面試」即可獲取
前言
眾所周知，maven 實質上是一個插件執行框架，所有的工作都是通過插件完成的。包括我們日常使用到的類似 install、clean、deploy、compiler。。。這些命令，其實底層都是一個一個的 maven 插件。
如何開發自己的插件
1. maven 插件的命名規范
在寫一個項目之前，第一件事就是確定一個名稱。maven 插件也不例外。它有著自己的一套命名規范。但是規范很簡單，一句話就可以概括，**官方插件命名的格式為 maven-xxx-plugin,非官方的插件命名為 xxx-maven-plugin 。**是不是覺得很眼熟，沒錯，spring boot starter 的命名也有類似的規范。
好的，我們的第一個 maven 插件項目就叫 demo-maven-plugin 吧。
2. 創建項目
名稱起好了，下一步就是創建這個項目。如果你使用 idea 的話，那么創建十分的便捷，按如下步驟即可：
2.1 選擇 org.apache.maven.archetypes:maven-archetype-mojo 為骨架創建項目
選擇創建新項目
選擇通過 maven 創建
勾選 Create from archetype 通過項目骨架創建
選擇?org.apache.maven.archetypes:maven-archetype-mojo
點擊下一步
2.2 輸入在第一步起的項目名
點擊 Next
2.3 點擊 Finish 完成項目創建
2.4? 分析項目文件
項目結構
可以看到生成的項目就是我們最最常見的 maven 項目的結構，生成的文件也很少，一個 pom.xml 文件，一個 MyMojo 文件，簡單介紹一下這兩個文件
?pom.xml
<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>cn.coder4j.study.example</groupId><artifactId>demo-maven-plugin</artifactId><packaging>maven-plugin</packaging><version>1.0-SNAPSHOT</version><name>demo-mavne-plugin Maven Mojo</name><url>http://maven.apache.org</url><dependencies><dependency><groupId>org.apache.maven</groupId><artifactId>maven-plugin-api</artifactId><version>2.0</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>3.8.1</version><scope>test</scope></dependency></dependencies> </project> ?首先生成的項目 pom.xml 中，自動依賴了兩個項目，一個是 maven-plugin-api ，這個是開發 maven 插件必須依賴的核心包。另一個是單元測試時使用的 junit 包。這兩個沒什么要注意的，真正要注意的是這個項目的 packaging，通常我遇到的 packaging 都是 jar、war、pom，這里比較特殊是 maven-plugin。
?MyMojo.java
package cn.coder4j.study.example;/** Copyright 2001-2005 The Apache Software Foundation.** Licensed under the Apache License, Version 2.0 (the "License");* you may not use this file except in compliance with the License.* You may obtain a copy of the License at** http://www.apache.org/licenses/LICENSE-2.0** Unless required by applicable law or agreed to in writing, software* distributed under the License is distributed on an "AS IS" BASIS,* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.* See the License for the specific language governing permissions and* limitations under the License.*/import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException;import java.io.File; import java.io.FileWriter; import java.io.IOException;/*** Goal which touches a timestamp file.** @goal touch** @phase process-sources*/ public class MyMojoextends AbstractMojo {/*** Location of the file.* @parameter expression="${project.build.directory}"* @required*/private File outputDirectory;public void execute()throws MojoExecutionException{File f = outputDirectory;if ( !f.exists() ){f.mkdirs();}File touch = new File( f, "touch.txt" );FileWriter w = null;try{w = new FileWriter( touch );w.write( "touch.txt" );}catch ( IOException e ){throw new MojoExecutionException( "Error creating file " + touch, e );}finally{if ( w != null ){try{w.close();}catch ( IOException e ){// ignore}}}} }
首先生成的類繼承了 AbstractMojo 這個抽象類，這里是 maven 插件的規范要求，maven 插件必須要繼承 AbstractMojo 并實現他的 execute 方法。
另外可以看到類與方法使用了很多 tag。注意是 tag 而不是注解，注解是直接標記的，而 tag 是在文檔注釋里面的。
其中?@goal 這個 tag 的作用是指定插件的命名，比如我們常用的 mvn clean，這個 clean 就是他的?@goal 。
而 @phase 是綁定插件執行的生成周期，比如你綁定在 clean 這個周期，那你在執行 clean 的時候會自動觸發你的插件。
@parameter 用來指定插件的參數。
小朋友你是否有很多問號？tag 這個東西寫在文檔注釋里面的東西，方便是方便但是容易寫錯呀，寫錯沒有語法報錯，寫對時候也沒有語法提示，為什么不直接用注解的形式呢？原因是 java 的注解是 jdk1.5 之后才有的，而實現 maven 的時候還沒有這種語法。所以要一條路走到黑，一直背這個歷史包袱嗎？當然不是，后面我們會說解決辦法。另外，這種寫法雖然不推薦使用了，但是有些 maven 的經典插件由于完成時間比較早，熟悉這些 tag 對于理解代碼也有幫助。
3. 開發插件
3.1 代碼未動，依賴先行?pom.xml
<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>cn.coder4j.study.example</groupId><artifactId>demo-maven-plugin</artifactId><packaging>maven-plugin</packaging><version>1.0-SNAPSHOT</version><name>demo-mavne-plugin Maven Mojo</name><url>http://maven.apache.org</url><dependencies><dependency><groupId>org.apache.maven</groupId><artifactId>maven-plugin-api</artifactId><version>3.5.2</version></dependency><dependency><groupId>org.apache.maven.plugin-tools</groupId><artifactId>maven-plugin-annotations</artifactId><version>3.5.2</version><scope>provided</scope></dependency></dependencies><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-plugin-plugin</artifactId><version>3.5.2</version></plugin></plugins></build> </project>
相較于默認的 pom.xml 文件，我們做了如下幾個變動：
升級 maven-plugin-api 的插件版本到 3.5.2 。原生的 2.0 實在是太老了。
添加 maven-plugin-annotations 這個依賴，還記得上面說的 tag 的事嗎？有了這個依賴就可以直接使用注解了
添加?maven-plugin-plugin 插件依賴，添加這個依賴主要是為了在 jdk1.8 能編譯通過，否則會報錯
3.2?DemoMojo.java
/*** * ** * * blog.coder4j.cn* * * Copyright (C) 2016-2020 All Rights Reserved.* ***/ package cn.coder4j.study.example;import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import org.apache.maven.plugin.MojoFailureException; import org.apache.maven.plugins.annotations.Mojo; import org.apache.maven.plugins.annotations.Parameter;/*** @author buhao* @version DemoMojo.java, v 0.1 2020-03-30 22:51 buhao*/ @Mojo(name = "hello") public class DemoMojo extends AbstractMojo {@Parameter(name = "name", defaultValue = "kiwi")private String name;public void execute() throws MojoExecutionException, MojoFailureException {getLog().info("hello " + name);} }
首先，同生成的類一樣，我們的類必須繼承 AbstractMojo 并實現他的 execute 方法，而 execute 方法其實就是這個插件的入口類。
示例代碼中有兩個很重要的注解，一個是 @Mojo ，它主要用來定義插件相關的信息相當于上面說的 @goal ，其中 name 屬性用來指定這個插件名稱，同 clean 類似。
另外一個重要注解?@Parameter ，則是用來指定插件運行時使用的參數，其中 name 是參數名，defaultValue 顧名思義是默認值，也就是在用戶沒有設置的時候使用的值。
詳細的插件及作用如下：
回到示例上了，我們這個插件作用很簡單，根據配置輸出 hello xxx，如果沒有配置就輸出 hello kiwi。我們在寫插件時，當然不會這樣寫，但是通過這個 demo，你就掌握了 maven 插件的大部分知識，可以自己做一些很有趣的插件。
4. 使用插件
首先上面我們的代碼寫完了，必須要 Install 一下，否則別的項目無法直接依賴，如果你還想給其它人使用，那還需上傳到 maven 倉庫。
4.1 依賴插件
<build><plugins><plugin><groupId>cn.coder4j.study.example</groupId><artifactId>demo-maven-plugin</artifactId><version>1.0-SNAPSHOT</version></plugin></plugins></build>
在我們想使用插件的項目中，添加如上配置，其中 plugin 中使用我們插件的? GAV 信息。
4.2 啟動插件
如果上面配置的都正確，那么在 idea 右側的 Maven 中，你配置的項目的 Plugins 下會多了一個 demo（具體根據你插件項目的名稱），而 demo 里面會有一個 demo:hello，其中這個 demo 對應你插件項目的名稱，而 hello 對應你插件的名稱也就是 @Mojo 中的 name 。
好的，我們雙擊一下，demo:hello ，會輸出如下日志：
這樣，我們的第一個 Maven 插件就好了。
4.3 配置參數
可能你還記得，我們在寫 DemoMojo 的時候還指定了一個 name 屬性，并且為它指定了一個 Parameter，這個如何使用。只要在依賴的插件下面添加 configuration 標簽就可以了。
其中 configuration 標簽內的標簽，對應你定義的參數名稱，而且 idea 還有語法提示，很 nice。
好的，我們再運行一下，結果如下：
好的，大功告成。
其它
參考鏈接
Maven 插件開發[1]
Maven 插件編寫[2]
項目源碼
因為篇幅有限，無法貼完所有代碼，如遇到問題可到 github[3] 上查看源碼。
最后，再附上我歷時三個月總結的?Java 面試 + Java 后端技術學習指南，這是本人這幾年及春招的總結，目前，已經拿到了大廠offer，拿去不謝！
下載方式
1.?首先掃描下方二維碼
2.?后臺回復「Java面試」即可獲取
Reference
[1]
Maven 插件開發: https://blog.gmem.cc/maven-plugin-development
[2]Maven 插件編寫: https://www.cnblogs.com/sniffs/p/11985699.html
[3]github: https://github.com/kiwiflydream/study-example/tree/master/demo-maven-plugin
總結
以上是生活随笔為你收集整理的【Maven】maven 插件开发实战的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 绝了！这款工具让 SpringBoot
- 下一篇： 面试官：你知道哪几种事务失效的场景？