1. 程式人生 > >Api管家系列(二):編輯和繼承Class

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

頁面 請求 很多 引用 定義 最終 繼承 mage 系列

上篇寫了個大概,今天我詳細說一下參數的編輯,廢話不多說

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

技術分享圖片

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

註意:只對新建的接口有用,對之前的接口和復制的接口無效

技術分享圖片

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

技術分享圖片

技術分享圖片

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

技術分享圖片

默認參數已經填入了

技術分享圖片

填入詳細信息,保存

技術分享圖片

新建接口時並沒有填寫請求參數和返回參數,所以界面上會提示繼續完善

技術分享圖片

點擊編輯或請求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管家的測試功能

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