swagger

再见 Swagger UI!国人开源了一款超好用的 API 文档生成框架

背景最近,栈长发现某些国内的开源项目都使用到了 Knife4j 技术,看名字就觉得很锋利啊!是不是这样的缩写呢:Knife4j = Knife for Java ?Java 匕首?看起来很牛逼的样子,当然,这是我简单的猜测,从字面上并不能猜到它是干嘛用的!那么它究竟是一个什么样的框架呢?Knife4j 简介Knife4j 的前身是 swagger-boots …

独具Swagger律动感GAWS 2016春季型录

将SWAG风潮作为设计核心的潮流品牌GAWS近日释出2016年春季Lookbook,设计师把美国嘻哈风格服饰与时下流行的细节相结合,以黑、白为基调,在服饰上融入了许多宗教风格图案以及抽象几何图形,打造出球服风T恤、长款连帽卫衣、太空棉棒球夹克、字母织带外套、两件式短裤+打底等款式,辅以金属拉链的装饰以及巧妙精致的拼接工艺,透着品牌一贯的高街味道。与此同时,满 …

使用Swager API Docs和easy-mock生成模拟数据

前面文章已经搭建了本地的easy-mock本地搭建Easy-Mock实现模拟数据常见的Mock方式:将模拟数据直接写在代码里利用javascript拦截请求利用Charles、Fiddler等工具拦截请求以上方式各有千秋,我们要说的是使用Swager API Docs和easy-mock生成模拟数据登录easy-mock创建项目点击+号创建项目填写项目信息归 …

WebApi 集成 Swagger_websphere集成解决方案控制台

1. Swagger(俗称:丝袜哥)是什么东西?Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。2.丝袜哥 …

还在用Swagger?试试这款零注解侵入的API文档生成工具

前后端接口联调需要API文档,我们经常会使用工具来生成。之前经常使用Swagger来生成,最近发现一款好用的API文档生成工具smart-doc, 它有着很多Swagger不具备的特点,推荐给大家。聊聊Swagger在我们使用Swagger的时候,经常会需要用到它的注解,比如@Api、@ApiOperation这些,Swagger通过它们来生成API文档。比 …

中年大叔学编程-Gin-Swagger生成API接口文档

最近简单的学习了一下Golang,并且用Gin开发了两个小应用,一个短域名生成,一个微信小程序。感受到了Golang的代码简洁、部署简单、内存占用少、零停机平滑重启等优势。在开发小程序的时候,需要生成接口文档,这里需要用到Gin-Swagger了,所以简单的就来整理一下。这里我用的环境是:go version go1.14.6 windowsamd64GoL …

Springboot集成Swagger2及常见配置(无坑版)

本文出自《愚公要移山》收录于《Springboot专题》中这种整合的文章确实已经烂大街了,写他一方面是补充我的springboot系列,另一方面确实还有一部分小伙伴没用过。最重要的是,如果你忘记了这种整合的代码。可以随时查阅。前言现在的开发基本上都是前后端分离,前后端交互都是通过API文档。有了API文档大家各自开发,互不干扰。1、传统方式传统方式是文档设计 …

让Swagger产出更加符合我们诉求的文档,按需决定显示或者隐藏

大家好,又见面啦。在前一篇文档《JAVA中自定义扩展Swagger的能力,自动生成参数取值含义说明,提升开发效率》中,我们探讨了如何通过自定义注解的方式扩展swagger的能力让Swagger支持自动从指定的枚举类生成接口文档中的字段描述的实现思路。其实swagger作为一个被广泛使用的在线接口文档辅助工具,上手会用很容易,但想用好却还是需要一定功夫的。所以 …

懒得写文档,swagger文档导出来不香吗

作者 | 唯一浩哥来源 | urlify.cnYJ3AFn前言早前笔者曾经写过一篇文章《研发团队,请管好你的API文档》。团队协作中,开发文档的重要性,这里就不再赘述,今天的话题集中在如何进一步提升更加高效的使用文档。离线文档swagger已经很方便了,我们为什么还需要离线文档?公司同一个项目组,一般只要集成了swagger基本就够了,但是难免会有跨组,甚至 …