springboot配置swagger

　　不久之前配置过swagger，因为比较顺利，懒得去记录，结果今天再配置的时候，各种坑，浪费了两个小时，牢记教训，还是记一下。

　　首先说一下为什么添加swagger模块，对于api项目来说，接口的管理和测试对于使用方来说，不怎么友好；为缓解这个问题，这才有了swagger。

　　接下来说一下配置步骤：

　　①、添加依赖

　　

        <!-- swagger -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.7.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.7.0</version>
        </dependency>

　　②、将swagger模块加载到spring上下文

　　

@Configuration
@EnableSwagger2
public class Swagger2Config {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                // select()函数返回一个ApiSelectorBuilder实例用来构建Docket
                .select()
                // Swagger会扫描该包下所有Controller定义的API，并产生文档内容
                .apis(RequestHandlerSelectors.basePackage("com.test.api"))
                // 不需要过滤接口
                .paths(PathSelectors.any())
                .build();
    }

    /**
     * Api的基本信息（这些基本信息会展现在文档页面中)
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("数据API")
                .description("data REST API, all the applications could access the data via JSON.")
                .version("1.0")
                .build();
    }
}

　　③、为swagger写一个http入口

/**
 * swagger 入口类
 */
@ApiIgnore
@Controller
@RequestMapping( "/swagger")
public class SwaggerCtrl {

    @RequestMapping(method = RequestMethod.GET)
    public String index(Map<String, Object> model) {
        return "redirect:swagger-ui.html";
    }

}

　　④、为需要提供出去的接口配置说明

@RestController
@Api(tags = "测试查询接口")
//@CrossOrigin
@RequestMapping("/test")
public class MyTestCtrl {

    @Resource
    private TestService testService;
    
    /**
     * 功能描述：查询最新一场数据
     */
    @RequestMapping(value = "lastest", method = RequestMethod.GET)
    @ResponseBody
    @ApiOperation(value = "查询最新一条数据" ,response = Result.class)
    public Result<?> lastest() {
        return testService.lastest();
    }
    
}

到这里就配置完成了，springboot启动之后，访问http://localhost:8081/swagger，如果报404，找不到页面，可能是编译问题，可以尝试一下mvn clean compile。

最后放一个正常运行的截图：