Api管家系列(二):編輯和繼承Class
上篇寫了個大概,今天我詳細說一下參數的編輯,廢話不多說
先打開一個項目,我要特別說一下設置裏的“默認參數設置”
打開默認參數設置,這裏我用紅色圈出的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