swagger使用

    io.springfox
    springfox-swagger2
    2.5.0



    io.springfox
    springfox-swagger-ui
    2.5.0

config下：


public class SwaggerConfig {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .pathMapping("/")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.xx.project.controller"))
                .paths(PathSelectors.any())
                .build().apiInfo(new ApiInfoBuilder()
                        .title("项目名称")
                        .description("描述")
                        .version("1.0")
                        .build());
    }
}

 

 

 

controller整体

@Api(tags = "xx")

 

方法上

@ApiOperation("xx")

@ApiImplicitParams({

        @ApiImplicitParam(name = "xxId", value = "id",  required = true, paramType = "query", dataType = "integer"),

        @ApiImplicitParam(name="xxName", value = "名称",required = true,paramType = "query", dataType = " string"),

})

@RequestMapping(value = "/xxxx", method = {RequestMethod.POST, RequestMethod.GET})