上篇写了个大概,今天我详细说一下参数的编辑,废话很少说程序员
先打开一个项目,我要特别说一下设置里的“默认参数设置”测试
打开默认参数设置,这里我用红色圈出的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管家的测试功能