Swagger2 (1)到此一游集成spring boot

1：认识Swagger2

Swagger2 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。

2.首先我们来看一下他能够做什么。（访问： localhost:8080/swagger-ui.html）

3.然后。

4.最后。

5.作用：

1. 接口的文档在线自动生成。

2. 功能测试。

6.我们可以用swagger2 解决的问题

由于接口众多，并且细节复杂（需要考虑不同的HTTP请求类型、HTTP头部信息、HTTP请求内容等），高质量地创建这份文档本身就是件非常吃力的事，下游的抱怨声不绝于耳。
随着时间推移，不断修改接口实现的时候都必须同步修改接口文档，而文档与代码又处于两个不同的媒介，除非有严格的管理机制，不然很容易导致不一致现象。（很多人都会说wiki 里面没有，而接口里面有）
可以节约在单元测试上的时间。

为了解决上面这样的问题，本文将介绍RESTful API的重磅好伙伴Swagger2，它可以轻松的整合到Spring Boot中，并与Spring MVC程序配合组织出强大RESTful API文档。它既可以减少我们创建文档的工作量，同时说明内容又整合入实现代码中，让维护文档和修改代码整合为一体，可以让我们在修改代码逻辑的同时方便的修改文档说明。另外Swagger2也提供了强大的页面测试功能来调试每个RESTful API。

7.接下来我们来玩一玩Swagger2：

首先pom 里面需要添加swagger2 的包

<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId><version>2.2.2</version>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>2.2.2</version>
</dependency>

因为鄙人现在使用的是spring boot 所以使用的配置是java config 这种模式，所以接下来是一个 swagger2config 类进行配置。

8.结果和之前的最后一样。

在我们的项目开发中，常常会因为我们的接口版本不对称导致反复的调试导致了我们会浪费大量的时间在测试上，so 现在我们可以利用swagger2 来提升大家的效率。

分享源码：我的源代码点这里。

Swagger2 (1)到此一游集成spring boot相关推荐

Spring精华问答 | 如何集成Spring Boot？
Spring框架是一个开源的Java平台,它提供了非常容易,非常迅速地开发健壮的Java应用程序的全面的基础设施支持.今天就让我们一起来看看关于Spring的精华问答吧. 1 Q:如何在自定义端口上运 ...
boot spring 获取请求端口浩_Spring精华问答 | 如何集成Spring Boot？
Spring框架是一个开源的Java平台,它提供了非常容易,非常迅速地开发健壮的Java应用程序的全面的基础设施支持.今天就让我们一起来看看关于Spring的精华问答吧. 1 Q:如何在自定义端口上运 ...
flowable集成spring boot ----任务监听器
任务监听器任务监听器(task listener)用于在特定的任务相关事件发生时,执行自定义的Java逻辑或表达式. 任务监听器包含下列属性: event(事件)(必填):触发任务监听器的任务事件类 ...
ElasticSearch快速入门（三）=＞集成Spring Boot + 效仿京东搜索小实战
六.集成Spring Boot 6.1 环境的搭建新建一个空项目新建一个spring boot模块发现导入的默认es依赖和我们本地的es版本不一样自定义es 的版本 <propertie ...
forkJoin集成spring boot
forkJoin集成spring boot处理大量数据添加 import com.wugui.datax.admin.entity.JobModel; import com.wugui.datax.a ...
Angular 6集成Spring Boot 2,Spring Security,JWT和CORS
主要内容:Spring Boot 2的基础应用.CORS配置.Actuator监控:Spring Boot集成springfox-swagger,利用Swagger生成JSON API文档,利用Swa ...
使用Cloudformation集成Spring Boot和EC2
在之前的博客中,我们将Spring Boot应用程序与Elastic beantalk集成在一起. 该应用程序是一个基于Servlet的应用程序,可以响应请求. 在本教程中,我们将部署一个Spring ...
SpringBoot实战（十二）:集成 Spring Boot Admin 监控
强烈推荐一个大神的人工智能的教程:http://www.captainbed.net/zhanghan [前言] 程序开发完实现相应的功能只是一个部分,如何让系统在线上运行更好创造更高的价值是另外一个 ...
RocketMQ 源码分析 —— 集成 Spring Boot
点击上方"芋道源码",选择"设为星标" 做积极的人,而不是积极废人! 源码精品专栏原创 | Java 2020 超神之路,很肝~ 中文详细注释的开源项目 RP ...

Swagger2 (1)到此一游集成spring boot

Swagger2 (1)到此一游集成spring boot相关推荐

最新文章

热门文章