今天栈长给大家推荐一款接口 API 设计神器,传说中的,牛逼哄洪的 Swaggerjava技术栈,它到底是什么?今天为大家揭开谜底!

Swagger是什么?

官网:

java中栈内存和堆内存_java栈和本地方法栈区别_java技术栈

Swagger 如官网所示,它是最好的 API 构建工具。

它是一个围绕 OpenAPI 规范构建的开源工具,它可以帮助我们设计、构建、记录和使用 REST API 接口。

Swagger 包含的主要套件:

java技术栈_java中栈内存和堆内存_java栈和本地方法栈区别

图片来源见博客水印。

OpenAPI是什么?

上面有说到 Swagger 是一个围绕 OpenAPI 规范构建的开源工具,那么 OpenAPI 是什么呢?

OpenAPI 规范,以前叫 Swagger 规范。它是一个为 REST APIs的接口定义的规范。OpenAPI 可以定义的 API 实体内容包括以下几个部分。

这个 OpenAPI 规范可以用 YAML 或者 JSON 来编写,这种格式非常易于学习,可读性对开发人员非常友好。

完整的 OpenAPI 规范可以去官网看一下。

编写文档地址:

为什么需要Swagger?

现在的互联网架构都是前后端分离的模式java技术栈,还有现在是移动互联网时代了,APP 需要与后端服务器通信也需要维护一套接口,API文档自然就成了前后端开发人员联系的纽带。

编写 API 文档的方式也各有不同,有用 WORD 编写的,有用 confluence 等编写的,但这些方式都不能动态更新,每次接口变更都需要手动维护文档,甚是麻烦。有了 Swagger,可以先做完接口,通过 Swagger 来动态生成和更新 API 文档。

后面的文章会继续介绍如何使用 Swagger 注解来自动生成 API 文档,及如何集成 Spring Boot 来应用实战,点击下面的了解更多链接关注Java技术栈,在后台回复关键字 “工具” 可获取所有历史 Java 工具类文章教程及更新。

版权申明:本文系 “Java技术栈” 原创,原创实属不易,转载、引用本文内容请注明出处,禁止抄袭、洗稿,请自重,尊重他人劳动成果和知识产权。


娜娜项目网每日更新创业和副业教程

网址:nanaxm.cn 点击前往娜娜项目网

站 长 微 信: nanadh666

声明: 本站内容转载于网络,版权归原作者所有,仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任,若侵犯到你的版权利益,请联系我们,会尽快删除处理!