springboot整合swagger2

springboot整合swagger2

下载依赖

	<dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
    	<version>2.9.2</version>
    </dependency>
    <dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>swagger-bootstrap-ui</artifactId>
        <version>1.9.3</version>
    </dependency>

swagger2配置代码

@Configuration
@EnableSwagger2
public class Swagger2 {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
                .select()
                // 包扫描
                .apis(RequestHandlerSelectors.basePackage("com.test.testweb.controller"))
                .build();
    }

    public ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("构建swagger2").version("1.0").build();
    }

}

Controller代码片段

@RestController
@Api("test")
public class TestController {


    @ApiOperation("test for swagger")
    @GetMapping("/hello")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "id", value = "id", required = true, dataType = "Integer"),
            @ApiImplicitParam(name = "name", value = "name", required = true, dataType = "String")
    })
    public String testSwagger(Integer id, String name){
        
    }
}

浏览器访问ip:port/doc.html