zoukankan      html  css  js  c++  java
  • 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管家的测试功能

  • 相关阅读:
    客户端用java api 远程操作HDFS以及远程提交MR任务(源码和异常处理)
    HighCharts终极版本
    Highcharts网页版
    情感化设计中的手绘应用表现
    前端批量下载文件
    PHP 大文件下载,文件传输,支持断点续传。 2g以上超大文件也有效
    PHP超大文件下载,断点续传下载
    php下载大文件,支持断点续传案例
    解决PHP超大文件下载,断点续传下载的方法详解
    PHP如何异步断点续传大文件
  • 原文地址:https://www.cnblogs.com/bkylacky/p/10768176.html
Copyright © 2011-2022 走看看