快捷導航

SpringBoot如何自動生成API文檔詳解

更新時間：2021年07月31日 13:28:48 作者：kikiki2

網(wǎng)絡(luò)程序正朝著移動設(shè)備的方向發(fā)展,前后端分離、APP,最好的交互交互方式莫過于通過API接口實現(xiàn),這篇文章主要給大家介紹了關(guān)于SpringBoot如何自動生成API文檔的相關(guān)資料,需要的朋友可以參考下

前言

在做項目的時候，如果項目是前后分離的，后端一定要和前端或者是移動端對接接口，那么問題來了，接口是不是要自己寫給他們看，一般的會采用Excel或者Word來寫，高級一點的就采用API管理平臺手工錄入，一個項目有上千上萬個接口，天啊，這是多么大的工作量，在接口維護的時候更加痛苦，為了解決這樣的事我們可以借助 japi 這個項目來完成RESTFul文檔的自動生成，完全基于注釋生成，更多詳細配置可查看https://github.com/dounine/japi。

使用說明

克隆項目下來

git clone https://github.com/dounine/japi.git

編譯打包

cd japi/java
gradle install -xtest

運行JAPI后臺管理

cd japi/java
gradle bootRun

運行JAPI文檔界面

cd japi/node
node app.js

生成RESTFul文檔

maven項目

<dependency>
    <groupId>com.dounine.japi</groupId>
    <artifactId>client</artifactId>
    <version>1.0</version>
</dependency>

gradle項目

compile group: 'com.dounine.japi', name: 'client', version: '1.0'

編輯resources/japi.properties配置文件

japi.name=test
japi.uuid=43a600877430438596de3d330e4bd06e
japi.version=1.0.0
japi.author=lake
japi.url=http://192.168.0.123:8080
japi.description=this is project description.
japi.createTime=2017-02-23 10:44:44
japi.icon=/home/lake/github/japi/html/img/logo.png
japi.server=http://192.168.0.179:7778
japi.server.username=japi
japi.server.password=japi123

編寫一個action

/**
 * 獲取用戶列表
 * @param user 用戶信息
 * @return class User
 * @version v2
 */
@GetMapping(value = "v2/list")
public Result hots(@Validated({User.UserDEL.class}) User user) throws RuntimeException {

    return null;
}

編寫一個API生成類

JapiCreateTest.java

@Test
    public void testCreate(){
        JapiClient.setPrefixPath("/home/lake/github/test-japi/java/");//項目路徑前綴
        JapiClient.setpostfixPath("/src/main/java");//項目路徑后綴

        JapiClient.setProjectJavaPath("client");//主項目地扯
        JapiClient.setActionReletivePath("com/dounine/test-japi/action");//相對主項目action包所在路徑
        //JapiClient.setIncludeProjectJavaPath(new String[]{"api"});//主項目中關(guān)聯(lián)的其它項目包路徑
        JapiClient.setIncludePackages(new String[]{"com.dounine.test-japi"});//關(guān)聯(lián)的包,用于準確快速搜索
        JapiClient.saveHistory(true);//是否保留本地歷史版本
        JapiClient.setFlushServer(false);//強制同步本地與服務(wù)器所有的版本（會先刪除服務(wù)器以前的歷史版本）

        IProject project = ProjectImpl.init();
        JapiClientStorage japiClientStorage = JapiClientStorage.getInstance();
        japiClientStorage.setProject(project);
        japiClientStorage.autoSaveToDisk();//自動使用到本地磁盤==> 用戶目錄/.japi-client/
        new JapiClientTransfer().autoTransfer(japiClientStorage);//文件傳輸?shù)街鞣?wù)器.
    }

最后訪問瀏覽器 http://localhost:7777

就可看到RESTFul文檔登錄