Spring cloud 集成swagger 在线文档入门

1. 为什么使用swagger

随着互联网技术的不断发展，前端与后端开发已实现分离，而且它们正在各自的道路上越走越远；而api接口文档就成为了前后端开发人员沟通的纽带。在没有api文档工具之前，一般接口文档都使用word进行记录，但是手写文档维护起来特别麻烦，尤其是对于多次修改的接口，开发人员并没有即时更新文档容易出现文档与代码对不上。而swagger的出现就很容易解决上述的问题，它是一款很好用的在线api文档框架。

swagger官网
swagger源码

2. 如何使用

pom文件添加swagger依赖

<dependency>
   <groupId>com.purgeteam.cloud</groupId>
   <artifactId>swagger-spring-cloud-starter</artifactId>
   <version>0.3.11.RELEASE</version>
</dependency>

添加swagger配置类

@EnableSwagger2
@Configuration
public class ProjectSwaggerConfig {
   
    @Bean
    public Docket