swagger 入门（一）

Swagger是什么？

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

个人总结： swagger的一个最大的优点是能实时同步“api与文档“保持一致性。在项目开发过程中，发生过多次：修改代码但是没有更新文档，前端还是按照老旧的文档进行开发，在联调过程中才发现问题的情况。
Swagger是很受欢迎的REST APIs文档生成工具之一

注意：
swagger对“restful风格的api“ 支持的比较好，非restful风格的api支持的不是很好，对于非restful风格的api或者其他语言（非java语言）可以采用 http://editor.swagger 编辑器来收工完成相关的API编写

https://www.zhihu.com/question/28119576
http://www.cnblogs.com/JoiT/p/6378086.html