swagger配置

1.pom.xml

<!--swagger2-->

        <dependency>

            <groupId>io.springfox</groupId>

            <artifactId>springfox-swagger2</artifactId>

            <version>2.6.1</version>

            <exclusions>

                <exclusion>

                    <groupId>io.swagger</groupId>

                    <artifactId>swagger-annotations</artifactId>

                </exclusion>

            </exclusions>

        </dependency>

<!--下面的不添加会导致访问报404-->

        <dependency>

            <groupId>io.springfox</groupId>

            <artifactId>springfox-swagger-ui</artifactId>

            <version>2.6.1</version>

        </dependency>

<!--swagger2密码-->

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-security</artifactId>

        </dependency>

application.properties添加swagger访问密码:

security.basic.enabled=true

security.basic.path=/swagger-ui.html

security.user.name=admin

security.user.password=123456

2.swagger配置类

参考：http://blog.didispace.com/springbootswagger2/

3.生成离线文档：

使用springfox-staticdocs生成swagger离线api文档附带源码

4.项目使用demo：

responseMessages.add(new ResponseMessageBuilder().code(999).message("未知异常").responseModel(new ModelRef(error)).build());

return

      new Docket(DocumentationType.SWAGGER_2).

                      apiInfo(buildApiInfo())

                      .tags(new Tag("tag1", "接口类描述1"),

                              new Tag("tag2", "接口类描述2")).

                      select().

                      apis(RequestHandlerSelectors.

                              basePackage(swaggerBasePackage)).

                      paths(PathSelectors.any()).

                      build()

                      .useDefaultResponseMessages(false)

                      .globalResponseMessage(RequestMethod.GET, responseMessages)

@Api(tags = {"tag1"})

@RestController

@RequestMapping(value = "test")

public class ResourceApi {

    //...some code...

    /**

     * @author Jill

     */

    @PostMapping

    @ApiOperation("查询资源列表接口")

    public Response<Object> getInfoList(@RequestBody @Valid

                                            @ApiParam(name = "查询条件", value = "查询条件")

                                                    SearchVO vo) {