使用Swagger2作为文档来描述你的接口信息 - 程序员 - 恒宇少年 | SpringBoot | SpringCloud | Java - 个人博客

[hengboy]

http://blog.yuqiyu.com/apiboot-swagger-describe-the-interface.html

接口文档在前后分离的项目中是必不可少的一部分，文档的编写一直以来都是一件头疼的事情，写程序不写注释、不写文档这几乎是程序员的通病，Swagger2的产生给广大的程序员们带来了曙光，只需要在接口类或者接口的方法上添加注解配置，就可以实现文档效果，除了可以应用到单体应用，在微服务架构中也是可以使用的，只需要整合zuul就可以实现各个服务的文档整合。