使用Swagger2实现RESTful文档

/api/版本号/资源

GET： 查询数据
POST： 提交新数据
PUT： 修改数据
DELETE： 删除数据

public class ApiResult<T> {
 public ApiResult() {}
 public ApiResult(boolean ok, int code, T data, String message) {
 super();
 this.ok = ok;
 this.code = code;
 this.data = data;
 this.message = message;
 }
 //处理是否成功
 private boolean ok;
 //结果状态号，类比Http状态码
 private int code;
 //返回的结果数据
 private T data;
 //返回消息
 private String message;
 // 省略 getter 和 setter......
}

public class ApiResultGenerator {
 private static final String DEFAULT_MESSAGE_SUCCESS = "SUCCESS"; //成功
 private static final String DEFAULT_MESSAGE_FAIL = "FAIL"; //失败
 private static final int RESULT_CODE_SUCCESS = 200; //成功
 private static final int RESULT_CODE_SERVER_ERROR = 500; //服务
 //...省略其它常量
 public static <T> ApiResult<T> success(T data){ //成功
 return new ApiResult<T>(true, RESULT_CODE_SUCCESS, data, DEFAULT_MESS
 }
 public static <T> ApiResult<T> success(){ //成功
 return new ApiResult<T>(true, RESULT_CODE_SUCCESS, null, DEFAULT_MESS
 }
 public static <T> ApiResult<T> error(String message){ //失败
 return new ApiResult<T>(false, RESULT_CODE_SERVER_ERROR, null, messag
 }
 public static <T> ApiResult<T> error(){ //失败
 return new ApiResult<T>(false, RESULT_CODE_SERVER_ERROR, null, DEFAUL
 }

<!-- Swagger-UI -->
 <dependency>
 <groupId>io.springfox</groupId>
 <artifactId>springfox-swagger2</artifactId>
 <version>2.8.0</version>
 </dependency>
 <dependency>
 <groupId>io.springfox</groupId>
 <artifactId>springfox-swagger-ui</artifactId>
 <version>2.8.0</version>
 </dependency>

@Configuration
@EnableSwagger2
public class Swagger2Config {
 @Bean
public Docket createRestApi() {
 return new Docket(DocumentationType.SWAGGER_2)
 .apiInfo(apiInfo())
 .select()
 //为当前包下controller生成API文档
 .apis(RequestHandlerSelectors.basePackage("funnyshop.web.api"
 //为有@Api注解的Controller生成API文档
 .apis(RequestHandlerSelectors.withClassAnnotation(Api.class))
 //为有@ApiOperation注解的方法生成API文档
 .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperati
 .paths(PathSelectors.any())
 .build();
 }
 private ApiInfo apiInfo() {
 return new ApiInfoBuilder()
 .title("FunnShop后端接口")
 .description("funnyshop-jee")
 .version("1.0")
 .build();
 }
}

@MapperScan("funnyshop.mapper")
@SpringBootApplication
@EnableSwagger2 //启用Swagger2
public class FunnyshopJeeApplication {
 public static void main(String[] args) {
 SpringApplication.run(FunnyshopJeeApplication.class, args);
 }
}

@ApiOperation("根据商品名称模糊查询商品列表")
 @GetMapping("")
 @ApiImplicitParams({@ApiImplicitParam(name = "name", value="商品名称，模糊
 public List<Product> findByName(String name){
 return productBiz.findProducts(name);
 }