java注釋轉(zhuǎn)json插件開發(fā)實戰(zhàn)詳解
目的
將java的代碼注釋轉(zhuǎn)換為json格式,并寫入文件
本文介紹了完整的開發(fā)流程及如何使用
運行環(huán)境
jdk1.8
maven3.x
設(shè)計思想
系統(tǒng)構(gòu)思
- 編譯完成的class里沒有注釋的,所以注釋信息只有在編譯代碼時存儲起來
- 將能夠生成javadoc.json的代碼做成maven插件
關(guān)鍵技術(shù)算法 需要實現(xiàn)Doclet
必須引入下述jar包, 來導(dǎo)入com.sun.javadoc.Doclet
<dependency> <groupId>com.sun</groupId> <artifactId>tools</artifactId> <version>1.8</version> <scope>system</scope> <systemPath>/home/zhaozhiwei/applications/jdk1.8.0_181/lib/tools.jar</systemPath> </dependency>
代碼路徑
<https:github.com:zhaozhiwei1992/javadoc-json-maven-plugin>
入口: com.example.Javadoc2JsonMojo#execute
生成javadoc.json文件
com.example.CommentToJson(做成maven插件使用)
{ "com.example.web.rest.PersonResource.findByID(java.lang.Long)#date": "2022/10/25-上午10:19", "com.example.web.rest.PersonResource#Package": "com/example/springbootcache/controller/PersonController.java", "com.example.web.rest.PersonResource.findByID(java.lang.Long)#Description": "根據(jù)id獲取用戶信息", "com.example.web.rest.PersonResource.save(Person)#method": "save", "com.example.web.rest.PersonResource#author": "zhaozhiwei", "com.example.web.rest.PersonResource.deleteByID(java.lang.Long)#Description": "根據(jù)id刪除person信息", "com.example.web.rest.PersonResource#Title": "PersonController", "com.example.web.rest.PersonResource.update(Person)#date": "2022/10/25-上午10:21", "com.example.web.rest.PersonResource.save(Person)#Description": "保存方法", "com.example.web.rest.PersonResource#Description": "用戶信息接口", "com.example.web.rest.PersonResource#date": "2022/10/25 下午8:23", "com.example.web.rest.PersonResource.update(Person)#Description": "修改內(nèi)容看是否會調(diào)整緩存", ... 省略了一大堆 }
類代碼注釋規(guī)范
/** * @Title: PersonController * @Package: com/example/springbootcache/controller/PersonController.java * @Description: 用戶信息接口 * @author: zhaozhiwei * @date: 2022/10/25 下午8:23 * @version: V1.0 */
方法代碼注釋規(guī)范
/** * @date: 2022/10/25-上午10:19 * @author: zhaozhiwei * @method: findByID * @param id : 唯一id * @return: com.lx.demo.springbootcache.domain.Person * @Description: 根據(jù)id獲取用戶信息 * 獲取十次, 只有第一次是讀庫,后續(xù)都是取緩存 * 直接刪掉redis緩存里的內(nèi)容,仍然可以獲取數(shù)據(jù),并且走緩存,此時獲取的是服務(wù)緩存ehcache中的信息 * seq 10 |xargs -i curl -XGET 'http://localhost:8080/persons/2' */
參數(shù)定義
@parameter額外屬性: @parameter alias="<aliasName>":為mojo參數(shù)使用別名 @parameter expression="${aSystemProperty}":使用系統(tǒng)屬性表達式對mojo參數(shù)進行賦值 @parameter defaultValue="aValue/${anExpression}":提供一個默認值
開發(fā)流程
項目構(gòu)建
mvn archetype:generate -DgroupId=com.example -DartifactId=javadoc-json-maven-plugin -DarchetypeArtifactId=maven-archetype-mojo -DinteractiveMode=false
使用插件
Install
在javadoc-json-maven-plugin項目中執(zhí)行maven的install命令,
將插件安裝到本地倉庫
引入自定義插件
在其它項目引入插件測試
展開插件可以看到Mojo列表,由于項目里只有一個Mojo,且Mojo上用注釋@goal指定了名稱為generate,所以這里只能看到一個javadoc-json:generate
<plugin> <groupId>com.example</groupId> <artifactId>javadoc-json-maven-plugin</artifactId> <version>2.0-SNAPSHOT</version> <configuration> <!-- 指定java注釋掃描目錄--> <basePackage>com/example/web/rest</basePackage> </configuration> </plugin>
執(zhí)行插件
雙擊javadoc-json:generate就會執(zhí)行這個插件。
執(zhí)行完畢后,可以看到項目根目錄的target文件下多了個javadoc.json文件。
命令行執(zhí)行插件(可選)
命令格式為mvn groupId:artifactId:version:goal,執(zhí)行如下命令:
mvn com.<example:javadoc-json-maven-plugin:1.0.0-SNAPSHOT:generate>
由于我們的插件命名符合規(guī)范,所以上面的命令可以簡寫為:
mvn javadoc-json:generate
尚未解決的問題
javadoc插件去掉異常提示
參考
maven插件開發(fā) http://www.dbjr.com.cn/article/283906.htm
參數(shù)定義 http://www.dbjr.com.cn/article/122552.htm
以上就是java注釋轉(zhuǎn)json插件開發(fā)實戰(zhàn)詳解的詳細內(nèi)容,更多關(guān)于java注釋轉(zhuǎn)json的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
SpringBoot整合Graylog做日志收集實現(xiàn)過程
這篇文章主要為大家介紹了SpringBoot整合Graylog做日志收集實現(xiàn)過程詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-12-12如果淘寶的七天自動確認收貨讓你設(shè)計你用Java怎么實現(xiàn)
在面試的時候如果面試官問淘寶的七天自動確認收貨讓你設(shè)計,你會怎么具體實現(xiàn)呢?跟著小編看一下下邊的實現(xiàn)過程,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值2021-09-09RocketMq同組消費者如何自動設(shè)置InstanceName
這篇文章主要介紹了RocketMq同組消費者如何自動設(shè)置InstanceName問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-06-06SpringBoot整合Kaptcha實現(xiàn)圖片驗證碼加減乘除功能
在開發(fā)Web應(yīng)用時,驗證碼是一個常見的功能,它可以幫助我們防止機器人的惡意操作,今天我們將學(xué)習(xí)如何使用Kaptcha生成圖片驗證碼,并自定義驗證碼內(nèi)容為100以內(nèi)的加減乘除運算,感興趣的朋友跟隨小編一起看看吧2024-07-07IDEA 重新導(dǎo)入依賴maven 命令 reimport的方法
這篇文章主要介紹了IDEA 重新導(dǎo)入依賴maven 命令 reimport的相關(guān)知識,本文通過實例代碼給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-04-04SpringMVC對自定義controller入?yún)㈩A(yù)處理方式
這篇文章主要介紹了SpringMVC對自定義controller入?yún)㈩A(yù)處理方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-09-09