Swagger框架学习分享

[size=x-large][color=black][b]Swagger框架学习分享
[/b][/color][/size]

[size=large][color=black][b]一、背景介绍[/b][/color][/size]
[size=medium][color=black][b]1.1.项目简介[/b][/color][/size]
Swagger项目是由Dilip Krishnan和Adrian Kelly等人维护开发的一个为[color=red][b]spring[/b][/color] Web MVC 项目提供方法文档的一个框架。该框架最主要的功能是将Controller的方法进行可视化的展现，像方法注释，方法参数，方法返回值等都提供了相应的用户界面，尤其是对JSON参数的支持。同时可以结合swagger-ui可以对用户界面进行不同程度的定制，也可以对方法进行一个简单的测试。

[size=medium][color=black][b]1.2.code repository[/b][/color][/size]
[list]
[*]github:[url]https://github.com/springdox/springdox[/url]
[*]maven：[url]http://www.mvnrepository.com/artifact/com.mangofactory/swagger-springmvc[/url]
[/list]

[size=medium][color=black][b]1.3.演示项目[/b][/color][/size]
[list]
[*]官方：[url]https://github.com/adrianbk/swagger-springmvc-demo[/url]
[*]民间：[url]https://github.com/qq291462491/bugkillers[/url]
[/list]

[size=large][color=black][b]二、开发准备[/b][/color][/size]
[size=medium][color=black][b]2.1.环境准备[/b][/color][/size]
[list]
[*]idea intellij 13+
[*]Oracle java 1.6
[*]Gradle 2.0 +
[/list]

参考：[url]http://blog.youkuaiyun.com/u010827436/article/details/44417637[/url]

Spring3 MVC中使用Swagger生成API文档
[url]http://blog.youkuaiyun.com/jia20003/article/details/50700736[/url]


http://swagger.io/docs/

Swagger 使用文档
参考：[url]http://www.2cto.com/kf/201604/499072.html[/url]