swagger

http://blog.csdn.net/wangnan9279/article/details/44541665

http://www.cnblogs.com/getupmorning/p/7267076.html

API表示一个开放的API，可以通过description简要描述该API的功能。 
在一个@API下，可有多个@ApiOperation，表示针对该API的CRUD操作。在ApiOperation Annotation中可以通过value，notes描述该操作的作用，response描述正常情况下该请求的返回对象类型。 
在一个ApiOperation下，可以通过ApiResponses描述该API操作可能出现的异常情况。 

ApiParam用于描述该API操作接受的参数类型

再接着，为项目的Model对象添加Swagger Annotation，这样Swagger Scanner可以获取更多关于Model对象的信息。