Swagger的详细使用教程，深入理解JVM的核心知识点

        <scope>provided </scope>

   </dependency>

**2.创建swagger配置类** 

import com.google.common.base.Predicates;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;

import springfox.documentation.builders.PathSelectors;

import springfox.documentation.service.ApiInfo;

import springfox.documentation.service.Contact;

import springfox.documentation.spi.DocumentationType;

import springfox.documentation.spring.web.plugins.Docket;

import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration

@EnableSwagger2

public class SwaggerConfig {

@Bean

public Docket webApiConfig(){



    return new Docket(DocumentationType.SWAGGER_2) //类型：swagger

            .groupName("webApi") //分组名称

            .apiInfo(webApiInfo()) //设置在线文档的信息

            .select()

            .paths(Predicates.not(PathSelectors.regex("/admin/.*")))

            .paths(Predicates.not(PathSelectors.regex("/error.*")))

            .build();



}



private ApiInfo webApiInfo(){

    return new ApiInfoBuilder()

            .title("网站-课程中心API文档")

            .description("本文档描述了课程中心微服务接口定义")

            .version("1.0")

            .contact(new Contact("java", "http://atguigu.com", "55317332@qq.com"))

            .build();

}

}

**3.若创建的swagger是新建的一个模块(若是在当前模块引入swager依赖，此步可以忽略),则：**



（1）将swagger模块的坐标导入依赖到要使用swagger的模块中 



（2）在启动类上添加@ComponentScan(basePackages={"swagger配置类所在的包路径"})



          假设：swagger所在包：com.atguigu.servicebase



                    启动类所在包：com.atguigu.service



                   则配置为@ComponentScan(basePackages = {"com.atguigu"})



**4.启动项目，访问http://ip:接口/swagger-ui.html进入swagger的控制台**



若有弹窗问题，则要刷新maven，重启项目



![](https://img-blog.csdnimg.cn/dca91dedc23e4324b689fd242c48b4f7.png)​



**5.接口测试**



页面中已经显示了可以测试的接口，点击要测试的接口，value处输入参数，点击Try it out发送



![](https://img-blog.csdnimg.cn/65f4ae4474c942cb9c6f37bc6f4cb2b0.png)​



**6.swagger生成api文档的常用帮助注解：**



以下这些注解用于生成api文档时，接口的提示信息



@Api(description = "讲师模块")：用在类上  

@ApiOperation(value = "讲师列表")：用在方法上  

@ApiParam(name = "id",value = "讲师id",required = true)：用在参数上




**自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。**

**深知大多数Java工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！**

**因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。**
![img](https://img-blog.csdnimg.cn/img_convert/6fc08ad215634e4f9426d35859f74643.jpeg)
![img](https://img-blog.csdnimg.cn/img_convert/b96d67c316fbbcadca31f863fe93d176.png)
![img](https://img-blog.csdnimg.cn/img_convert/c4dfd1799db6b148946a05cbd9883bc4.png)
![img](https://img-blog.csdnimg.cn/img_convert/ca9445119a3523e7806fd273013c16f9.png)
![img](https://img-blog.csdnimg.cn/img_convert/804fa5b5816eecf69642a037fa41c191.png)
![img](https://img-blog.csdnimg.cn/img_convert/8a5b72a3753fb3f8f5639c178f51c0d9.png)

**既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，真正体系化！**

**由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新**

**如果你觉得这些内容对你有帮助，可以添加V获取：vip1024b （备注Java）**
![img](https://img-blog.csdnimg.cn/img_convert/0e001b5787c11f679f104fefaf92e0e7.jpeg)



# 最后

各位读者，由于本篇幅度过长，为了避免影响阅读体验，下面我就大概概括了整理了

![](https://img-blog.csdnimg.cn/img_convert/663a8dba48d2e16660d80844b7466b56.webp?x-oss-process=image/format,png)

![](https://img-blog.csdnimg.cn/img_convert/99cb99261c6321c30638eb05a4ecf432.webp?x-oss-process=image/format,png)

![](https://img-blog.csdnimg.cn/img_convert/b569cacbbc2fd2edeb4d783a2de8a5b2.webp?x-oss-process=image/format,png)

![](https://img-blog.csdnimg.cn/img_convert/f4f969c415a89c1b8f52b3218ed7f2c8.webp?x-oss-process=image/format,png)



[**一个人可以走的很快，但一群人才能走的更远。如果你从事以下工作或对以下感兴趣，欢迎戳这里加入程序员的圈子，让我们一起学习成长！**](https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0)

**AI人工智能、Android移动开发、AIGC大模型、C C#、Go语言、Java、Linux运维、云计算、MySQL、PMP、网络安全、Python爬虫、UE5、UI设计、Unity3D、Web前端开发、产品经理、车载开发、大数据、鸿蒙、计算机网络、嵌入式物联网、软件测试、数据结构与算法、音视频开发、Flutter、IOS开发、PHP开发、.NET、安卓逆向、云计算**


**AI人工智能、Android移动开发、AIGC大模型、C C#、Go语言、Java、Linux运维、云计算、MySQL、PMP、网络安全、Python爬虫、UE5、UI设计、Unity3D、Web前端开发、产品经理、车载开发、大数据、鸿蒙、计算机网络、嵌入式物联网、软件测试、数据结构与算法、音视频开发、Flutter、IOS开发、PHP开发、.NET、安卓逆向、云计算**