一：新建SpringBoot工程

在这里插入图片描述

勾选Web依赖

项目搭建好了将这些无关紧要的可以删除

写个controller进行测试

没问题~

二：导入Swagger相关的依赖

在这里插入图片描述

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

三：配置Swagger的config

在这里插入图片描述

访问 http://localhost:8080/swagger-ui.html

注意：这里访问不了这个页面可能是因为依赖级别太高了尝试降级试试 Version 2.9.2

四：配置Swagger信息

整到这里，你是否有了疑问，为啥有这个页面呢

这其实就是swagger默认配置的页面

接下来看源码了解一下~
进入Docket类
在这里插入图片描述

原来如此：那么我们也可以自定义swagger配置玩一玩！

在Swagger的配置文件中注册Swagger的Docket实例bean对象

@Configuration
@EnableSwagger2 //开启Swagger2
public class SwaggerConfig {
    //配置了Swagger的 Docket 的bean实例
    @Bean
    public Docket docket(){
        return new Docket();
    }
    ...

此时我们暂未知 new Docket()参数应该填啥进去Docket类中看看
在这里插入图片描述

那么我们就可以修改成 new Docket(DocumentationType.SWAGGER_2);

再查看Docket类有啥方法
在这里插入图片描述
于是乎… 我们整一个自定义的api信息

 //配置Swagger信息
    public ApiInfo apiInfo(){
      
    }

不知道里面应该写啥就看看apiInfo类呗~
在这里插入图片描述

滑到最下面可以看到

嗯~ 我们直接返回一个这个就行了

//配置Swagger信息
    public ApiInfo apiInfo(){
        return new ApiInfo(
                "Api Documentation",
                "Api Documentation",
                "1.0",
                "urn:tos",
                DEFAULT_CONTACT,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList());
    }

可以看到下面这里爆红了~🐕
在这里插入图片描述
查看源码发现原来是静态成员变量呀

那我们就自己整一个替换就好了

 //配置Swagger信息
    public ApiInfo apiInfo(){
        //作者信息
        Contact contact = new Contact("潮汕奴仔", "", "");
        return new ApiInfo(
                "潮汕奴仔配置Swagger",
                "潮汕奴仔 Api Documentation",
                "C1.0",
                "urn:tos",
                contact,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList());
    }