swagger自定义返回Map（swagger返回参数说明）
原创：小姐姐味道（微信公众号ID：xjjdog），欢迎分享，转载请保留出处。
流年不利流年不利啊。项目写的太傻，庞大到生成了几百兆的Swagger文档。
通常，有个几兆就到了忍受极限了，这直接爆出几百兆。
问题源于这么一篇文章：
小技巧：SpringBoot项目如何让前端开发提高效率？
。其中提到使用swagger可以让前端、后端、QA、产品互动起来，很多研发已经用了。但有些项目生成的文章忒TM大了（抱歉我控制不住），在让这些项目愉快的go die之前，还是得想办法处理呀。
接口减肥
第一就是过滤减肥。
看一下你的Controller里写的是不是
@RequestMapping
这个注解将会生成7条api信息。
GET、HEAD、POST、PUT、DELETE、OPTIONS、PATCH
如果你能够确定调用方法，比如GET，请将注解改成
@GetMapping
不要有循环引用
返回的实体，还有请求的参数，不要循环引用。请干掉这些代码，不要邋遢，设计一点干净的api。
转线下
另一种思路就是把这些api都给捣鼓到线下，倒入到一个统一的地方进行管理。
这些也已经有很多产品了，比如Rap、Nei、YApi。
拿YApi来说(支持源码搭建)，可以输入相应swagger的地址，进行一次导入，就可以将api定义转到另一个平台了。
YApi还有权限管理功能，应该是这里面做的最Nice的了。如果你想要统一管理、内网隔离，推荐一试。好东西，就不多介绍了。
结尾
转到线下虽然解决了因为api过大造成的服务不稳定，但api的更新同步会是另外一个问题。
不管采用何种方式，合理简洁的api设计是首要的。调用方法固定，不循环引用，最重要的，记得分模块哦。
作者简介：小姐姐味道 (xjjdog)，一个不允许程序员走弯路的公众号。聚焦基础架构和Linux。十年架构，日百亿流量，与你探讨高并发世界，给你不一样的味道。我的个人微信xjjdog0，欢迎添加好友，?进一步交流。?
相关推荐
-
火影羁绊3.1d（火影羁绊3.2隐藏英雄密码）
火影羁绊3.1d（火影羁绊3.2隐藏英雄密码） 火影羁绊3.1d是一款非常经典的魔兽地图，它的魅力在于它可以让你体验到火影忍者的世界观，可以选择很多种不同的忍者来战斗，这也是它成为…
-
十大邪异武功中原镖局（中原镖局第一高手）
大家好，我是冬日暖阳，今天给大家带来的是，四本超级解压的神级小说，主角脑路清奇，让人一看笑得肚子疼！ 《贫道真不想搞钱啊》作者：六月观主 贫道真不想搞钱啊简介: 贫道斩妖除魔，只为…
-
14寸笔记本电脑尺寸（14寸笔记本电脑尺寸是多少厘米）
14寸笔记本电脑尺寸（14寸笔记本电脑尺寸是多少厘米） 在如今的信息时代，笔记本电脑已经成为人们工作、学习和娱乐的必备工具。而在众多的笔记本电脑品牌中，14寸笔记本电脑的尺寸备受关…
-
北京燕星宇怎么样，北京众创空间名单
国创基地荣誉簿上再添重要一项！由北京市科委发布的“第六批北京市众创空间”征集活动，近日通过北京创业孵育协会网站公布了最终入围名单，国创基地凭借在“双创”领域取得的突出成绩，与大唐创…
-
大写n的笔顺怎么写(z大写字母怎么念)
小科专注帮孩子更轻松的进步，助父母更全面的美满，凡是与孩子和父母有关的，就记得来找小科哦！今天小科给大家带来26个大小写字母儿歌及最规范的书写方法，爸爸妈妈们快看了教孩子吧，在家期…
-
iphone手机论坛（苹果手机 论坛）
随着科技的发展，智能手机成为了人们日常生活中必不可少的工具之一。在众多智能手机品牌中，苹果iPhone手机因其稳定性、高质量、优秀的用户体验和丰富的生态系统备受消费者欢迎。为了更好…
-
广州机床展怎么样，广东华昱机电
临清市华昱精密机械有限公司专业致力于直线导轨的研发和生产。 3月1日-3日，广州广交会展馆，临清市华昱精密机械有限公司将参展2023广州国际轴承展，展位号D88。现诚邀广大观众莅临…
-
山村吃人（山村小吃）
如果你正在看一档美食节目，之后却有人告诉你节目嘉宾是一个食人恶魔以后，你会是什么样的反应？在日本，就曾发生过这样的事情…… 佐川中年 可怜的里尼不仅早早失去了自己的生命，还没有得到…
-
中联大药房（湖北中联大药房）
“力争持续保证供应，不涨价，让广大市民安心放心。” 25日，正月初一一大早，武汉市市场监管局紧急行动，核查全市各大连锁药房防护口罩与抗病毒药品供销情况时，各大连锁药房相关负责人纷纷…
-
自动除霜的冰箱好吗
自动除霜的冰箱好吗？这是一个备受消费者关注的问题。在这个科技日新月异的时代，冰箱作为家庭必备电器之一，其功能和性能也在不断升级。自动除霜功能是近年来冰箱市场上的一项新技术，它能够有…
如发现本站有涉嫌抄袭侵权/违法违规等内容，请联系我们举报！一经查实，本站将立刻删除。