Springboot + Swagger3 集成和配置

本文将简单介绍Springboot 集成 Swagger3,

关于Springboot + Swagger2 可以查看: Springboot + Swagger2 集成和配置

基于前文的基础,简单介绍下swagger3,

Swagger3在Swagger2的基础上进行了部分升级, 使用和Swagger2没有多少区别。

一个重要的优化是依赖的引入,由之前的多个依赖变更为一个依赖,跟随springboot-starter风格,同时引入了新的开关注解 @EnableOpenApi 以代替@EnableSwagger2 。

因此,集成工作变得更加的简便了,必要工作只有两个,添加swagger3的starter依赖包,在springboot主程序类添加@EnableOpenApi开关注解。

下面快速介绍以下如何集成和配置

1.创建Springboot项目

IDEA创建springboot项目

在这里插入图片描述
Maven依赖

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>
    </dependencies>

2. 配置Swagger

2.1 (必选)添加开关注解@EnableOpenApi

@SpringBootApplication
@EnableOpenApi
public class DemoSwagger3Application {

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

}

输入访问路径 /swagger-ui/index.html
在这里插入图片描述

2.2 (可选)自定义首页属性 Docket配置

@Configuration
public class Swagger3 {

    @Bean
    public Docket docket() {
        return new Docket(DocumentationType.OAS_30).apiInfo(
                new ApiInfoBuilder()
                        .contact(new Contact("Kern", "", "825***@qq.com"))
                        .title("Swagger2测试项目")
                        .build()
                );
    }
}

输入访问路径 /swagger-ui/index.html
在这里插入图片描述
完成。

3. 使用第三方UI

添加如下依赖

        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.9.6</version>
        </dependency>

查看资源包
在这里插入图片描述

输入访问地址 /doc.html
在这里插入图片描述
也可以网路上去查找其他的UI包,自己去试试吧。

  • 1
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值