Springboot集成swagger

Springboot集成swagger

一、导入swagger所需maven依赖包

        
        
            io.springfox
            springfox-swagger2
            2.6.1
        

        
            io.springfox
            springfox-swagger-ui
            2.6.1
        

二、wagger配置类

目录结构配置如下

wagger 配置目录.png

wagger.java 代码如下

特别要注意的是里面配置了api文件也就是controller包的路径，不然生成的文档扫描不到接口。

@Configuration
public class Swagger2 {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.volunteer.sys.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("springboot利用swagger构建api文档")
                .description("简单优雅的restfun风格，http://blog.csdn.net/saytime")
                .version("1.0")
                .build();
    }
}

三、Application.class 加上注解@EnableSwagger2 表示开启Swagger

代码如下

@Controller
@SpringBootApplication
@EnableSwagger2
@MapperScan(basePackages = "com.volunteer.sys.dao")
public class VolunteerHelpApplication {

    @RequestMapping("/")
    @ResponseBody
    String home() {
        return "Hello World!";
    }

    public static void main(String[] args) {
        SpringApplication.run(VolunteerHelpApplication.class, args);
    }

}

四、测试

在浏览器打开http://localhost:8080/swagger-ui.html#/

如图，配置成功

swagger配置成功页面.png