首页 > 其他 > 详细

Swagger3文档瘦身

时间:2019-03-15 12:09:08      阅读:407      评论:0      收藏:0      [点我收藏+]

3.1简化数据模型

通过可重用定义来重构出现有重复定义的文档

eg.当在文档中多次出现关于person的定义时

            required:
              - username
            properties:
              firstName:
                type: string
              lastName:
                type: string
              username:
                type: string
将关于重复出现的person定义抽取出来
definitions: #添加定义项
Person:
            required:
              - username
            properties:
              firstName:
                type: string
              lastName:
                type: string
              username:
                type: string
需要用到这个定义时,用$ref属性来引用即可
$ref:"#/definition/Person" #引用一个定义来增加另一个定义

 

Swagger3文档瘦身

原文:https://www.cnblogs.com/itmeatball/p/10536023.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!