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管家的测试功能

相关文章
相关标签/搜索