swagger3.0应用指南

1.引用3个依赖

        <dependency>

            <groupId>io.springfox</groupId>

            <artifactId>springfox-boot-starter</artifactId>

            <version>3.0.0</version>

        </dependency>

        <dependency>

            <groupId>io.springfox</groupId>

            <artifactId>springfox-swagger2</artifactId>

            <version>3.0.0</version>

        </dependency>

        <dependency>

            <groupId>io.springfox</groupId>

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

            <version>3.0.0</version>

        </dependency>

2.配置注解类

@Configuration

@EnableOpenApi

public class SwaggerConfig {

    @Bean

    public Docket createRestApi() {

        List<SecurityContext> securityContexts = Collections.singletonList(SecurityContext.builder()

                .securityReferences(Collections.singletonList(SecurityReference.builder()

                        .reference("Authorization")

                        .scopes(new AuthorizationScope[]{new AuthorizationScope("global",

                                "accessEverything")}).build()))

                .build());

        List<SecurityScheme> authKey = Collections.singletonList(new ApiKey("Authorization", "Authorization", "header"));

        return new Docket(DocumentationType.OAS_30)

                .securityContexts(securityContexts)

                .securitySchemes(authKey)

                .apiInfo(apiInfo())

                .enable(true)

                .select()

                .apis(RequestHandlerSelectors.any()) // 指定路径

                .paths(PathSelectors.any())

                .build();

    }

    /**

     * 创建一个ApiInfo对象

     *

     * @return

     */

    private ApiInfo apiInfo() {

        return new ApiInfoBuilder()

                .title("消息通讯系统接口")

                .description("就是消息之间的通讯")

                .contact(new Contact("kyler","www.baidu.com","66889966@qq.com"))

                .version("v1.0.0")

                .build();

    }

}

3.改properties

spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER

浏览器输入localhost:8080/swagger-ui/index.html即可访问