如何在SptingBoot项目中引入swagger生成API文档

目录

背景介绍,swagger的必要性

swagger的引入:

[1.首先我们需要在 pom.xml文件中导入jar包](#1.首先我们需要在 pom.xml文件中导入jar包)

2.给swagger创建一个配置类:

3.为实体类添加注解

4.为controller添加注解


背景介绍,swagger的必要性

自从在2005年前端工程师诞生之后,随着js技术的进步和人们对网页的需求越来越高,全栈式程序员逐渐满足不了需求,所以前后端分离就被人提了出来。

然而,前后端分离虽然相比于全栈式减轻了程序员的负担但也产生了一个新的问题:前后端的交流问题。

因为我们知道,前端和后端是高度依赖的,在前端和后端进行数据传输的时候经常会因为一些命名问题导致报错,全栈式程序员会遇到这个问题更何况前后端分离。所以命名的规范以及前后端程序员的沟通就显得非常重要。

在这个过程中,需要我们后端程序员来给前端提交一个API文档。上面介绍着我们的那些方法,以及实体类中的变量名称,这是一个非常麻烦的问题,那么,有没有一个组件能帮助我们后端程序员自动生成这个API文档呢?

也就我们的主角登场:swagger

swagger可以帮助我们在创建实体类的时候就创建这个API仅仅只需要一些注解标签。

swagger的引入:

1.首先我们需要在 pom.xml文件中导入jar包

复制代码
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-openapi2-spring-boot-starter</artifactId>
<version>4.4.0</version>
</dependency>

2.给swagger创建一个配置类:

复制代码
@Configuration
@EnableSwagger2WebMvc
public class Knife4jConfiguration {

    @Bean(value = "dockerBean")
    public Docket dockerBean() {
        //指定使用Swagger2规范
        Docket docket=new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(new ApiInfoBuilder()
                        //描述字段支持Markdown语法
                        .description("# Knife4j RESTful APIs")
                        .termsOfServiceUrl("https://doc.xiaominfo.com/")
                        .contact("xiaoymin@foxmail.com")
                        .version("1.0")
                        .build())
                //分组名称
                .groupName("用户服务")
                .select()
                //这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage("com.ffyc.news.web"))
                .paths(PathSelectors.any())
                .build();
        return docket;
    }
}

3.为实体类添加注解

4.为controller添加注解

最后我们需要前段的访问地址:

http://ip:端口/doc.html

相关推荐
盗理者3 小时前
Python 工具: Windows 带宽监控工具
开发语言·windows·python
Rookie小强3 小时前
基于SpringBoot即刻出发畅游网
java·spring boot·后端
纪莫3 小时前
技术面:Java并发(上下文切换、线程安全、并发与并行、守护线程、虚拟线程)
java·java面试⑧股
望获linux3 小时前
【Linux基础知识系列:第一百一十六篇】使用mt进行磁带驱动管理
java·linux·运维·服务器·数据库·windows·嵌入式软件
灵犀学长3 小时前
Spring Boot集成Kafka常见业务场景最佳实践实战指南
java·spring boot·后端·kafka
lskblog3 小时前
使用 PHP Imagick 扩展实现高质量 PDF 转图片功能
android·开发语言·前端·pdf·word·php·laravel
梅坞茶坊4 小时前
PHP操作LibreOffice将替换变量后的word文件转换为PDF文件
开发语言·c#
丑小鸭是白天鹅4 小时前
嵌入式C语言之链表冒泡排序
c语言·开发语言·链表
通往曙光的路上4 小时前
JAVA 十二幕啦啦啦啦啦啦啦啊啦啦啦啦a
java·开发语言·算法