Api管家系列(二):編輯和繼承Class

上篇寫了個大概,今天我詳細說一下參數的編輯,廢話很少說程序員

先打開一個項目,我要特別說一下設置裏的「默認參數設置測試

打開默認參數設置,這裏我用紅色圈出的tab能夠設置請求頭,返回頭和返回狀態,這些設置會在新建接口的時候自動填入定義好的參數3d

注意:只對新建的接口有用,對以前的接口和複製的接口無效blog

我這裏設置一下請求頭和返回狀態,保存繼承

接下來開始新建接口,點擊新增接口接口

默認參數已經填入了文檔

填入詳細信息,保存引用

新建接口時並無填寫請求參數和返回參數,因此界面上會提示繼續完善請求

點擊編輯或請求Class說明旁邊的按鈕,能夠回到編輯界面,請求和返回Class就出現了,特別介紹下設置父Class,能夠大大減小未來維護接口文檔和修改代碼的工做量程序

點擊設置父Class,會彈出Class設置的頁面,圈出的「是不是內部Class」的選項表示是否有其它接口會用到這個Class,不勾就會顯示在選擇外部Class的列表中

點擊「選擇外部Class」,出現外部Class的列表,能夠很方便的引用

注意1:雖然外部Class使用方便而且能夠處處引用,但仍是強烈建議減小使用外部Class若是外部Class太多,這個列表會很長,找起來比較麻煩

注意2:這裏刪除按鈕必須是引用計數爲0纔會出現,應該是出於防止誤刪的考慮吧

選擇其中一個來使用,而後直接保存 

這樣父Class就設置好了,回到第一個參數編輯的頁面,能夠看到從父Class繼承的參數已經填好,而且在這個頁面是不能修改的。

注意1:當父Class被修改,這裏的繼承的參數也會自動被修改,維護就方便了不少

注意2:角上的減號能夠直接刪除本身的父Class,父Class的參數也會被一塊兒刪除

保存一下咱們的接口,這裏有個提示,實際上是由於返回Class並無設置,設置完了就不會有提示了

這裏有我最終生成的文檔,圈出了5個Class

生成-->生成代碼-->Java-->Gson

一下就寫好5個Class, 還帶註釋

好了,搞接口去了,強烈要求請求返回都能生成,牛逼的程序員都應該是隻搞邏輯的,雜事就應該是自動生成的

下次更新會介紹API管家的測試功能

相關文章
相關標籤/搜索