SpringBoot 精通系列-使用Swagger2构建RESTful APIs

导语
  在之前的博客中曾经说过关于SpringBoot RESTful架构的知识，也提供了一个简单的小例子，当然在实际工作中更多的使用的是Swagger来实现一个RESTful的API。那么下面就来看看如何利用Swagger来构建一个RESTful APIs

什么是Swagger

  Swagger是一个RESTfulAPI的工具，通过Swagger可以获取到项目的各种交互文档，以及客户端SKD的自动生效等功能。
  Swagger的可以实现RESTful风格API的标准定义，与所用的开发语言无关，使用者和计算机是看不到源码或者是开发文档，或者说不能通过网络流量检测的情况下，可以发现和理解各种服务。当服务通过Swagger定义，消费者就能通过远程的服务调用来实现少部分的逻辑。类似于低级编程接口，Swagger去掉了服务调用的时候的猜测。实现了直接调用。是一个功能强大的API表达工具。
  使用SpringBoot 来集成 Swagger，是要通过注解标记出需要在API中展示的信息，Swagger会根据项目中标记的注解来生成对应的API文档。Swagger是世界上最流行的API工具，提供了API的管理解决方案，API所需要的所有的要素在其中有所包含，也可以实现定制。

快速开发

导入依赖POM文件

  在开发之前首先需要解决的是SpringBoot如何集成Swagger2.x，需要在POM文件中导入如下的依赖。