springboot整合swagger

已于 2022-06-15 23:53:17 修改
阅读量1.4k 收藏 1
点赞数
文章标签： spring boot java spring
于 2022-06-15 22:56:17 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_48524739/article/details/125305949
版权

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。可用于：1.接口的文档在线自动生成、2.功能测试。

首先创建一个简单的maven项目，整合swagger一定要注意springboot与swagger的版本要适配，pom文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>swagger</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>swagger</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.2</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.7.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.7.0</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

项目的目录如下所示，创建swagger配置文件，具体内容如下，包自己导入。

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket webApiConfig(){
        return new Docket(DocumentationType.SWAGGER_2)
                .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("mzz", "http://www.baidu.com",
                "1345656307@qq.com"))
         .build();
         }
}

 数据库信息：

CREATE TABLE `user` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `name` varchar(20) DEFAULT NULL COMMENT '姓名',
  `age` int(11) DEFAULT NULL COMMENT '年龄',
  `sex` varchar(1) DEFAULT NULL COMMENT '性别',
  `address` varchar(255) DEFAULT NULL COMMENT '地址',
  `phone` varchar(20) DEFAULT NULL COMMENT '电话',
  `create_time` varchar(20) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8


insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('2','张三','22','男','上海市','13867675656','2020-12-26');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('3','李四','20','男','合肥市','13978786565','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('5','赵柳','20','男','南京市','13978786565','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('6','钱望','22','男','深圳市','13867675656','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('7','李云','20','男','合肥市','13978786565','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('8','张傅','22','男','上海市','13867675656','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('9','李青','20','男','合肥市','13978786565','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('10','王二发','22','男','昆明市','13867675656','2020-11-18');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('12','王得贵','22','女','成都市','13867674565','2022-05-10');
insert into `user` (`id`, `name`, `age`, `sex`, `address`, `phone`, `create_time`) values('13','lih','23','男','我的粉丝的方式电池','12345678901','2022-05-09');

数据库：

 application.properties配置文件：

# 服务端口
server.port=8080

# mysql数据库连接
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/users?serverTimezone=GMT%2B8&characterEncoding=UTF-8
spring.datasource.username=root
spring.datasource.password=

mybatis.mapper-locations=classpath:mapper/*.xml

#mybatis日志
mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

entity部分代码，使用lombok注解：

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private int id;
    private String name;
    private int age;
    private String sex;
    private String address;
    private String phone;
    private String createTime;
}

mapper部分代码，只简单的写了二个方法：

public interface UserMapper {

    //根据id查询
    public User getUserById(int id);

    //查询所有
    public List<User> getAllUser();



}

service及实现类部分代码：(代码跟mapper差不多，遵循规范最好写一下)

public interface UserService {

    //根据id查询
    public User getUserById(int id);

    //查询所有
    public List<User> getAllUser();


}

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public User getUserById(int id) {
        User user = userMapper.getUserById(id);
        return user;
    }

    @Override
    public List<User> getAllUser() {
        return userMapper.getAllUser();
    }
    }

}

xml部分代码：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.swagger.mapper.UserMapper">

    <select id="getUserById" resultType="com.example.swagger.entity.User">
        select id,name,age,sex,address,phone,create_time from user where id = #{id}
    </select>

    <select id="getAllUser" parameterType="list" resultType="com.example.swagger.entity.User">
        select id,name,age,sex,address,phone,create_time from user
    </select>


</mapper>

controller代码：

@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserService userService;

    @ApiOperation(value = "id获取用户信息")
    @GetMapping("{id}")
    public User getUserById(@PathVariable("id") int id){
        return userService.getUserById(id);
    }

    @ApiOperation(value = "获取所有用户信息")
    @GetMapping("/allUser")
    public List<User> getAllUser(){
        return userService.getAllUser();
    }

}

启动类（注意注解）：

@SpringBootApplication
@MapperScan("com.example.swagger.mapper")
public class SwaggerApplication {

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

}

最后启动项目，输入地址http://localhost:8080/swagger-ui.html#/，出现该页面表示swagger整合成功。

点击对应的接口进行测试：

 

1.查询所有用户信息：

2.通过id查询用户

 所有结果与数据库结果对应，swagger整合成功，测试成功。

注：上述entity,mapper,service以及xml等都可以通过mybatis-plus来实现。

mozzm
关注
SpringBoot整合Swagger
m0_59092234的博客
07-29 978
先自我介绍一下，小编13年上师交大毕业，曾经在小公司待过，去过华为OPPO等大厂，18年进入阿里，直到现在。深知大多数初中级java工程师，想要升技能，往往是需要自己摸索成长或是报班学习，但对于培训机构动则近万元的学费，着实压力不小。因此我收集了一份《java开发全套学习资料》送给大家，初衷也很简单，就是希望帮助到想自学又不知道该从何学起的朋友，同时减轻大家的负担。发现是springboot版本太高，缺少swagger运行所需要的环境，回退到之前的版本。注如果项目启动报错。...
springBoot整合Swagger项目例子
01-22
SpringBoot整合Swagger项目是一个实用的例子，它展示了如何在SpringBoot应用程序中集成Swagger，以便于创建API文档和进行接口测试。Swagger是一个强大的工具，用于设计、构建、文档化和使用RESTful Web服务。在这个...
Spring Boot-集成Swagger
最新发布
2401_86984462的博客
09-07 1877
再通过Swagger衍生出来的一系列项目和工具，就可以做到生成各种格式的接口文档，生成多种语言的客户端和服务端的代码，以及。
SpringBoot——整合Swagger
戏拈秃笔的博客
08-17 1855
Swagger是一款基于RESTful接口的用于文档在线自动生成和功能测试的开发工具 为了减少前后端开发人员在开发期间的频繁沟通，可以使用Swagger提供的接口文档和线上接口进行前后端功能联调
SpringBoot整合Swagger3生成接口文档过程解析
08-18
SpringBoot整合Swagger3生成接口文档过程解析 SpringBoot整合Swagger3生成接口文档过程解析是当前项目中非常重要的一部分，在前后端分离的项目中，接口文档的存在十分重要。 Swagger是一个自动生成接口文档的工具...
springboot整合swagger2实例
02-28
SpringBoot整合Swagger2实例详解 在现代Web开发中，API文档的重要性不言而喻，它为开发者提供了清晰的接口说明，使得开发、测试和维护工作更加高效。Swagger2是一款流行的API文档工具，它能自动生成RESTful API的...
springboot整合swagger2的demo.zip
03-10
.title("Spring Boot整合Swagger2示例") .description("这是一个使用Spring Boot和Swagger2构建的RESTful API") .version("1.0.0") .license("Apache 2.0") .licenseUrl(...
SpringBoot-整合Swagger
可达鸭的博客
06-03 286
Springboot2.7.0整合Swagger2.0 JDK1.8
SpringBoot集成Swagger
yu的博客
03-23 255
现在的编程从后端时代向逐渐编程后端分离的时代，前后端通过API接口进行交互，前后端相对独立，于是Swagger就产生了，它是一个简单但功能强大的API表达工具，号称最流行的API框架。使用Swagger生成API，我们可以得到交互式文档，自动生成代码的SDK以及API的发现特性等。Swagger官网Vue+Springboot 是现今主流的前后端分离的方案。
SpringBoot整合swagger
m0_59860403的博客
06-14 1374
1.在pom中引入swagger依赖2.编写配置类 可以直接将这个配置类复制到项目中，可以更改一下这些描述和接口路径 3.将项目再次刷x新启动一下，在浏览器中输入http://localhost:8201/swagger-ui.html端口号为自己项目的端口号，就会出现以下界面,即为整合成功......
SpringBoot整合Swagger与Actuator实战教程
SpringBoot整合Swagger和Actuator可以极大地提升API文档的质量、应用监控的效率，对于现代微服务架构的开发和维护具有重要意义。通过理解它们的优势和互补功能，开发者能够更好地构建健壮和易维护的API体系。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

mozzm

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值