Java非侵入式API接口文檔工具apigcc用法詳解
更新時間：2020年07月06日 09:15:57 作者：BarryW
這篇文章主要介紹了Java非侵入式API接口文檔工具apigcc用法詳解,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下
一個非侵入的api編譯、收集、Rest文檔生成工具。工具通過分析代碼和注釋，獲取文檔信息，生成RestDoc文檔
前言
程序員一直以來都有一個煩惱，只想寫代碼，不想寫文檔。代碼就表達了我的思想和靈魂。
Python提出了一個方案，叫docstring，來試圖解決這個問題。即編寫代碼，同時也能寫出文檔，保持代碼和文檔的一致。docstring說白了就是一堆代碼中的注釋。Python的docstring可以通過help函數直接輸出一份有格式的文檔，本工具的思想與此類似。
代碼即文檔
Apigcc是一個非侵入的RestDoc文檔生成工具。工具通過分析代碼和注釋，獲取文檔信息，生成RestDoc文檔。
有這樣一段代碼
/**
* 歡迎使用Apigcc
* @index 1
*/
@RestController
public class HelloController {
/**
* 示例接口
* @param name 名稱
* @return
*/
@RequestMapping("/greeting")
public HelloDTO greeting(@RequestParam(defaultValue="apigcc") String name) {
return new HelloDTO("hello "+name);
}
}
使用方式
apiggs-maven-plugin
easy use apigcc with maven
安裝
<plugin>
<groupId>com.github.apiggs</groupId>
<artifactId>apiggs-maven-plugin</artifactId>
<version><!-- 替換為上方版本號 --></version>
<executions>
<execution>
<phase>compile</phase>
<goals>
<goal>apiggs</goal>
</goals>
</execution>
</executions>
<configuration>
<!-- options in there -->
</configuration>
</plugin>
when you compile source code, apiggs will build rest doc.
options
- id 項目id，生成id.html文件
- title 文檔標題
- description 文檔描述
- production 輸出文件夾，默認為 apiggs
- out 輸出目錄，默認為 target
- source 源碼目錄
- dependency 源碼依賴的代碼目錄，以逗號隔開
- jar 源碼依賴的jar包目錄，以逗號隔開
- ignore 忽略某些類型
- version 文檔版本號
執(zhí)行方法：
查看API文檔：
另外，也可以放入容器遠程訪問，方法如下：
運行項目
gradlew build
cd service\build\libs
java -jar apigcc-hub-{version}.jar
以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
這篇文章主要介紹了基于Java8實現(xiàn)提高Excel讀寫效率,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-11-11
SpringBoot中使用configtree讀取樹形文件目錄中的配置詳解
這篇文章主要介紹了SpringBoot中使用configtree讀取樹形文件目錄中的配置詳解,configtree通過spring.config.import?+?configtree:前綴的方式,加載以文件名為key、文件內容為value的配置屬性,需要的朋友可以參考下2023-12-12
這篇文章主要介紹了使用dom4j解析xml文件問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-09-09
這篇文章主要介紹了JVM運行時數據區(qū)原理解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2019-08-08
分析并解決Intellij IDEA覆蓋tomcat配置的問題/解決修改server.xml無效的問題，本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友一起看看吧2021-02-02
這篇文章主要介紹了Java設計模式之備忘錄模式的使用,備忘錄模式中的發(fā)起者和管需要的朋友可以參考下2016-02-02
這篇文章主要給大家介紹了關于JAVA為什么要使用封裝及如何封裝的相關資料,封裝就是將屬性私有化,提供公有的方法訪問私有屬性,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2023-10-10
這篇文章主要介紹了springmvc流程圖以及配置解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2019-09-09
淺析Bean?Searcher?與?MyBatis?Plus?區(qū)別介紹
Bean?Searcher號稱任何復雜的查詢都可以一行代碼搞定，但?Mybatis?Plus?似乎也有類似的動態(tài)查詢功能，最近火起的?Bean?Searcher?與?MyBatis?Plus?倒底有啥區(qū)別？帶著這個問題一起通過本文學習下吧2022-05-05
Lombok注解之@SuperBuilder--解決無法builder父類屬性問題
這篇文章主要介紹了Lombok注解之@SuperBuilder--解決無法builder父類屬性問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-09-09