认识Swagger和Springfox

做过Java后端开发的同学应该都用使用过Springfox和Swagger，但我相信很多同学都对这两个工具的理解和使用都有问题。

Swagger是什么

根据官网的介绍，Swagger是一系列用于Restful API开发的工具，开源的部分包括：

• OpenAPI Specification：API规范，规定了如何描述一个系统的API
• Swagger Codegen：用于通过API规范生成服务端和客户端代码
• Swagger Editor：用来编写API规范
• Swagger UI：用于展示API规范

非开源的部分包括：

• Swagger Hub：云服务，相当于Editor + Codegen + UI
• Swagger Inspector：手动测试API的工具
• SoapUI Pro：功能测试和安全测试的自动化工具
• LoadUI Pro：压力测试和性能测试的自动化工具

Springfox是什么

在大量的中文教程中，Springfox以这样的方式出现

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