RESTful 风格的 Web 服务框架 Swagger

RESTful 风格的 Web 服务框架 Swagger

Apache
Java 查看源码»
跨平台
2012-09-19
红薯

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。

总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法、参数和模型紧密集成到服务器端的代码,允许 API 来始终保持同步。Swagger 让部署管理和使用功能强大的 API 从未如此简单。

Swagger

的码云指数为
超过 的项目
加载中

评论(17)

ifsc01
ifsc01
说污染代码的,是代码没写法
纯24K爷们儿
纯24K爷们儿
代码入侵
那年初二
那年初二
用它做API文档还是挺不错的
MrXionGe
MrXionGe
这里我给打3颗星。就像上面说的,确实有点污染代码,而且在项目开始的时候用比较合适,中途加入的话效果不尽人意。。我不推荐用他的代码生成,至少他的代码风格和我是不一样的。用它做API文档还是不错的,方便不同团队之间的配合。小团队的话就不如当面喊一嗓子来的快。
再睡一下
再睡一下
前后端绑死了~~除非一开始就用这套,后来的都接不上的
qwfys
qwfys
不错。
123咔哒
123咔哒
开发效率降低 并且真的不好看 污染代码
c
caochaojie
使用Swagger 通过localhost 能正常访问,使用IP访问就出现空白页面 要如何解决呢
m
mkyong
侵入太大
shore
shore
一个url都没扫到,什么鬼

Swagger Core 2.0.1 发布,构建时支持 JDK 9/10

Swagger Core 2.0.1 已发布,该版本主要是修复 bug,也引入了新特性,如对 JDK 9/10 的支持。 有以下值得关注的更新: JDK 9/10 support in build (#2735) Supports OpenAPIExtension decora...

2018/04/17 16:45

Swagger-core v2.0.0 发布,只生成 OpenAPI 3.0 规范

2.0.0 版本在 rc4 版本的基础上对 OpenAPI 3.0 主要特性作了增加支持。 显著特性更新包括但不限于: 首次正式支持 OpenAPI 3.0。Swagger-core 现在只生成 OpenAPI 3.0 规范,它不向后兼容 v1...

2018/03/28 15:56

Swagger 1.5.16 发布,RESTful 风格的 Web 服务框架

Swagger 1.5.16 已发布,Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。 该版本未提供最新的发行说明,了解更多可查阅发行列表 下载地址: Sour...

2017/07/17 14:12

Swagger 1.5.14 发布,RESTful 风格的 Web 服务框架

Swagger 1.5.14 已发布。v1.5.14 添加了一些功能,修复了一些问题。 新功能: 升级 logback 至 1.2.3 #2182 来自命名空间注释更好的支持 XML #2246 支持 Jackson 的 @JsonSerializeAs 注释 ...

2017/06/15 14:52

Swagger 高危漏洞影响 Java、PHP 和 Ruby等语言

广泛使用的Swagger规格(今 年初重命名为OpenAPI)发现了高危漏洞,潜在影响到了Java、PHP、NodeJS和 Ruby等流行语言开发的应用。该漏洞允许攻击者远程执行代码,存在于Swagger Code Genera...

2016/06/27 07:15

Swagger Core 1.5.9 发布,RESTful 框架

Swagger-Core 1.5.8 发布了,Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的...

2016/05/16 10:43

Swagger-Core 1.5.8 发布,RESTful 框架

Swagger-Core 1.5.8 发布了,Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的...

2016/03/12 22:31

Linux 基金会联合谷歌微软推出“开放 API 战略”

近日,Linux 基金会宣布推出“开放 API 战略”( Open API Initiative )以促成一个更加广泛、开放的 API 标准,创始成员包括谷歌、微软、IBM 等科技巨头,这项战略基于现有的 Swagger (已收...

2015/11/07 08:35

没有更多内容

加载失败,请刷新页面

没有更多内容

3
回答
swagger 内部类的问题

使用swagger生产在线api文档时,我的多个响应BO里定义了同名的内部类,如下: //class-A public class AQueryRsp e...

2018/07/06 16:32
2
回答
SwaggerUI 在传递嵌套对象时,怎么使嵌套对象的描述在前端显示?

以上是代码 下面是效果 我想要atttachments能显示它的JSON格式

2018/03/23 10:59
3
回答
本地测试时,swagger显示页面时,不显示接口,页面空白,需要等五分钟才显示,重启tomcat后也不行

本地测试时,swagger显示页面时,不显示接口,页面空白,需要等五分钟才显示,重启tomcat后也不行

06/17 14:14
1
回答
swagger 中@ApiImplicitParam()跟@ApiParam()两个注解的区别

swagger 中@ApiImplicitParam()跟@ApiParam()两个注解的区别?

03/04 20:44
1
回答
springboor+swagger 无法正常显示?

访问 swagger-ui.html 弹出 Unable to infer base url. This is common when using dyn...

4
回答
springboot项目 用swagger测试 但是不出现接口,求助大神啊!

大神们帮忙看一下 这是哪儿出了问题啊?

2018/05/17 08:29
3
回答
swagger处理同一个实体给不同的接口展示不同的属性 ?
混乱羽翼 的回答 04/15 11:57
最佳答案
你自己都说咯,有的公司通过新建不同的实体来解决 这个办法其实不仅仅是为了swagger,而是接口的入参和出参在不同接口中要求可能就是不一致的,拆分开来比较好一些
1
回答
swagger如何测试List<实体类>
风吹屁屁凉 的回答 03/28 11:46
最佳答案
使用POST,@RequestBody注解,参数使用list接收,在swagger-ui界面放入JSON Array数据就可以了
2
回答
swagger设置全局参数(例如token),但是部分接口不需要该全局参数,如何配置?
白菜粉条炖猪蹄儿 的回答 03/22 09:45
最佳答案
@Bean(value = "defaultApi") public Docket defaultApi() { List<Parameter> pars = new ArrayList<Parameter>(); ParameterBuilder tokenPar = new Paramet...
1
回答
阿里Druid URI监控如何去除swagger的访问

阿里Druid URI监控如何去除swagger的访问 如图:

03/01 17:05

没有更多内容

加载失败,请刷新页面

swagger入门及swagger-maven-plugin使用

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful风格的Web服务。[推荐-翻译](

2016/04/16 15:29
2.7K
1
Swagger上手教程

swagger零基础教程

2016/07/23 21:08
1K
0
基于Chrome浏览器的swagger-bootstrap-ui

swagger-bootstrap-ui-extension 简介 随着swagger-bootstrap-ui已经历时两年多,发布了26个版本,目前也得到的很多Java开发者的青睐,如果你是使用Swagger来构建你的文档服务,那么,swagger-bo...

05/14 16:22
302
2
Swagger Integration

This wiki writes down the integration between spring-boot and Swagger. Swagger is a powerful restful API framework. It can discover and generate documentation for rest API by us...

2016/04/26 15:35
31
1
koa框架 mp2 node服务搭建swagger服务

说明:用koa2搭建静态文件服务器,mp2管理node服务,搭建swagger-ui和swagger-editor服务,项目地址:koa-swagger 1、环境搭建 安装最新版nodejs 新建文件夹koa-swagger,在文件夹内创建swa...

2018/07/04 11:59
672
0
Swagger环境搭建之非依赖代码法

前言 Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集...

2016/10/15 20:06
1K
0
Swagger2与Spring REST Docs

编者注 之前让其他写服务端的小伙伴支持swagger,然后最近一直在写Unity,没有把之前的项目和Swagger进行集成 Swagger Core Swagger Core Git Swagger 2.X 快速开始 注意:Swagger 2.x 遵循O...

02/21 14:12
142
0
RESTful API 利器 Swagger

原文博客地址: http://www.razorer.com/2016/10/16/swagger-intro/ 目前公司的项目对外交互都是采用 http resful的协议进行通信,数据格式采用 JSON RESTFUl的风格, 这种组合比较轻量级, 基本...

2016/10/16 14:10
48
0
Swagger 这一个文章就够了

Swagger 这一个文章就够了 From:https://blog.csdn.net/crisschan Swagger快速理解 Swagger:The Best APIs are Built with Swagger Tools 。Swagger可以定义一个标准的RESTful风格的API,与...

昨天 10:36
4
0
用Swagger调用Harbor Registry的REST API

本文原作者为开源企业级容器Registry Harbor项目的工程师王锟,主要介绍如何使用Harbor内置Swagger来测试和调用Harbor的API。笔者做了少量修改。 Swagger简介 Swagger是最流行的RESTful API...

2016/04/21 11:26
1K
1

没有更多内容

加载失败,请刷新页面

返回顶部
顶部