springfox源码_Java类springfox.documentation.builders.ParameterBuilder的实例源码 - 编程字典...

/**

* ApiImplicitParam 与 ApiParam 的区别

* ApiImplicitParam: This is the only way to define parameters when using Servlets or other non-JAX-RS environments.

*

* 对Servlets或者非 JAX-RS的环境，只能使用 ApiImplicitParam。

* 在使用上，ApiImplicitParam比ApiParam具有更少的代码侵入性，只要写在方法上就可以了，但是需要提供具体的属性才能配合swagger ui解析使用。

* ApiParam只需要较少的属性，与swagger ui配合更好。

* 传递复杂对象 By ModelAttribute

* (1) ModelAttribute 是Spring mvc的注解，这里Swagger可以解析这个注解，获得User的属性描述--good

* 原文链接：http://www.jianshu.com/p/b730b969b6a2

* (2)传递复杂对象 By RequestBody

* json格式传递对象使用RequestBody注解

* (3) PathVariable是Spring 的注解，对于这种简单的参数，就可以不用写ApiParam来描述接口参数。

*

*

* Every Docket bean is picked up by the swagger-mvc framework - allowing for multiple

* swagger groups i.e. same code base multiple swagger resource listing