本文共 1898 字，大约阅读时间需要 6 分钟。

Swagger是什么

Swagger 是一系列 RESTful API 的工具，通过 Swagger 可以获得项目的一种交互式文档，客户端 SDK 的自动生成等功能。

使用 Spring Boot 集成 Swagger 的理念是，使用注解来标记出需要在 API 文档中展示的信息，Swagger 会根据项目中标记的注解来生成对应的 API 文档。Swagger 被号称世界上最流行的 API 工具，它提供了 API 管理的全套解决方案，API 文档管理需要考虑的因素基本都包含，这里将讲解最常用的定制内容。

简单使用

1.创建springboot项目

   			
    
     io.springfox
    			
    
     springfox-swagger2
    			
    
     2.8.0
    		
   		
   			
    
     io.springfox
    			
    
     springfox-swagger-ui
    			
    
     2.8.0
    		
   

3.创建配置类:

@Configuration     //启动时加载此类@EnableSwagger2  //表示此项目启用 Swagger API 文档public class SwaggerConfig {
       @Bean    public Docket api() {
           return new Docket(DocumentationType.SWAGGER_2)                .apiInfo(apiInfo())                .select()                // 自行修改为自己的包路径                .apis(RequestHandlerSelectors.basePackage("com.snow.hello"))                .paths(PathSelectors.any())                .build();    }    @Bean    public ApiInfo apiInfo() {
       return new ApiInfoBuilder()            .title("hello")            .description("hello API 1.0 操作文档")            .version("1.0")            .termsOfServiceUrl("https://blog.csdn.net/shelleylittlehero/article/details/80621592")            .contact(new Contact("littleHero","https://blog.csdn.net/shelleylittlehero/article/details/80621592","1772085788@qq.com"))            .build();    }}

4.启动application;访问 ,发现报错:

这是由于在项目中出现了一个很不起眼的错误:

注意:

需要注意的是:WebController中出现了@RequestMapping(name="/getUser")应为@RequestMapping(value="/getUser"),修改过之后可以访问页面,我推测,在Springboot启动过程中应该是对注解做了校验的;后期可以研究一下.

Swagger常用注解