当前位置: 首页 > article >正文

spring boot 3.x 整合Swagger3

环境介绍

  • jdk版本: 17
  • spring boot 版本:3.2.0
  • Swagger3版本:2.2.0

整合Swagger

添加依赖

<dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>2.2.0</version>
 </dependency>

添加配置类 

package com.tech.cloud.config;

import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class Swagger3Config {

    // 按模块定义 当前支付模块
    @Bean
    public GroupedOpenApi PayApi() {
        return GroupedOpenApi.builder().group("支付微服务模块")
                .pathsToMatch("/pay/**").build();
    }

    // 举例其他模块
    @Bean
    public GroupedOpenApi OtherApi() {
        return GroupedOpenApi.builder().group("其他微服务模块")
                .pathsToMatch("/other/**", "others").build();
    }


    // 生成文档
    @Bean
    public OpenAPI docsOpenApi() {
        return new OpenAPI()
                .info(new Info().title("cloud_tech")
                        .description("通用架构设计")
                        .version("v1.0"))
                .externalDocs(new ExternalDocumentation()
                        .description("整合目前微服务最新组件,基于jdk17、spring boot3.2.0")
                        .url("www.baidu.com"));
    }

}

在项目中使用

接口中使用

  • 类上 @Tag(name = "支付服务模块", description = "支付CRUD")
  • 方法上  @Operation(summary = "新增", description = "新增支付流水方法")

@RestController
@Slf4j
@Tag(name = "支付服务模块", description = "支付CRUD")
public class PaymentController {
    @Resource
    private PaymentService payService;

    @PostMapping(value = "/pay/add")
    @Operation(summary = "新增", description = "新增支付流水方法")
    public ResultData<String> addPay(@RequestBody PaymentPO pay) {
        System.out.println(pay.toString());
        int i = payService.add(pay);
        return ResultData.success("成功插入记录,返回值: " + i);
    }

    @DeleteMapping(value = "/pay/del/{id}")
    @Operation(summary = "删除", description = "删除支付流水方法")
    public ResultData<Integer> deletePay(@PathVariable("id") Integer id) {
        int i = payService.delete(id);
        return ResultData.success(i);
    }

    @PutMapping(value = "/pay/update")
    @Operation(summary = "修改", description = "修改支付流水方法")
    public ResultData<String> updatePay(@RequestBody PayDTO payDTO) {
        PaymentPO pay = new PaymentPO();
        BeanUtils.copyProperties(payDTO, pay);
        int i = payService.update(pay);
        return ResultData.success("成功修改记录,返回值: " + i);
    }

    @GetMapping(value = "/pay/get/{id}")
    @Operation(summary = "按照ID查流水", description = "查询支付流水方法")
    public ResultData<PaymentPO> getPayInfo(@PathVariable("id") Integer id) {
        return ResultData.success( payService.getById(id));
    }

    @GetMapping(value = "/get/all")
    @Operation(summary = "获取所有", description = "获取所有")
    public ResultData getAll() {
        List<PaymentPO> all = payService.getAll();
        return ResultData.success(all);
    }

}

实体类中使用

  • 类上和字段上@Schema(title = "主键")

@Data
@Table(name = "t_pay")
@Schema(title = "支付交易表实体类")
public class PaymentPO {
    @Id
    @GeneratedValue(generator = "JDBC")
    @Schema(title = "主键")
    private Integer id;

    /**
     * 支付流水号
     */
    @Column(name = "pay_no")
    @Schema(title = "支付流水号")
    private String payNo;

    /**
     * 订单流水号
     */
    @Column(name = "order_no")
    @Schema(title = "订单流水号")
    private String orderNo;

    /**
     * 用户账号ID
     */
    @Column(name = "user_id")
    @Schema(title = "用户账号ID")
    private Integer userId;

    /**
     * 交易金额
     */
    @Schema(title = "交易金额")
    private BigDecimal amount;

    /**
     * 删除标志,默认0不删除,1删除
     */
    private Byte deleted;

    /**
     * 创建时间
     */
    @Column(name = "create_time")
    @Schema(title = "创建时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date createTime;

    /**
     * 更新时间
     */
    @Column(name = "update_time")
    @Schema(title = "更新时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date updateTime;
}

访问Swagger

主机名:端口/swagger-ui/index.html,我这里访问http://localhost:9100/swagger-ui/index.html

 按模块展示

 

查看标注的实体类 


http://www.kler.cn/a/373149.html

相关文章:

  • 大语言模型(LLM)快速理解
  • IEEExtreme 18
  • 【论文阅读笔记】VLP: A Survey on Vision-language Pre-training
  • Linux文件系统学习(未完)
  • C++ 中回调函数的实现方式-函数指针
  • linux驱动—在自己的总线目录下创建属性文件
  • pcie5.0接口的主板--战未来
  • 爬虫+数据保存2
  • Caffeine 本地缓存测试频繁 GC 场景及部分源码分析
  • Tomcat UrlRewriteFilter 部署项目虚拟路径配置,路由重写,可参考配置部署前端控制路由项目(Vue,React 等)
  • 【华为HCIP实战课程二十四】中间到中间系统协议IS-IS配置实战,网络工程师
  • ChatGPT、Python和OpenCV支持下的空天地遥感数据识别与计算——从0基础到15个案例实战应用
  • 机器学习中的嵌入是什么?
  • 计算机毕业设计PySpark+大模型高考推荐系统 高考分数线预测 高考爬虫 协同过滤推荐算法 Vue.js Django Hadoop 大数据毕设
  • Leetcode—3216. 交换后字典序最小的字符串【简单】
  • 从零到一构建C语言解释器-CPC源码
  • P2link 远程桌面服务的主要用途
  • 安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口(持续更新)
  • 【C++进阶】C++11(中)
  • AbstractQueuedSynchronizer
  • 0基础入门matlab
  • K8s 容器的定向调度与亲和性
  • 大厂面经:京东嵌入式面试题及参考答案
  • 安全研究 | 不同编程语言中 IP 地址分类的不一致性
  • ZeroNL2SQL:零样本 NL2SQL
  • 第三百零三节 Log4j教程 - Log4j安装