2024年最新Knife4j实现微服务聚合API文档实战

注意的是,这边location必须使用如下图所示的内容,否则无法识别,会报异常

在这里插入图片描述

微服务聚合模式

微服务聚合方式分为Disk、Cloud、Eureka、Nacos四种模式,只是配置不同,都很简单

Disk本地模式

开发者只需要在Spring Boot的项目中存在OpenAPI规范的JSON文件即可进行聚合

配置yml配置文件如下:

server:
  port: 9090
knife4j:
  enableAggregation: true
  disk:
    enable: true
    routes:
      - name: 用户
        location: classpath:openapi/user.json

配置目录如下:

在这里插入图片描述

启动后效果如下:

在这里插入图片描述

Cloud模式聚合

Cloud(云端)模式和Disk模式大同小异,主要的区别是获取OpenAPI规范的方式换成了基于HTTP接口而已

配置yml配置文件如下:

# knife4j配置
knife4j:
  # 开启聚合
  enableAggregation: true
  # Cloud模式
  cloud:
  	# 开启
    enable: true
    # 路由配置
    routes:
      - name: easypoi测试
        uri: localhost:8001
        location: /v2/api-docs?group=WEB接口文档1.0版本
      - name: kafka测试
        uri: localhost:8002
        location: /v2/api-docs?group=WEB接口文档1.0版本

Eureka注册中心聚合

从Eureka注册中心进行聚合的模式和Cloud模式大同小异,主要的区别是通过serviceName来替代了真实的目标服务地

knife4j:
  enableAggregation: true
  eureka:
    enable: true
    serviceUrl: http://localhost:10000/eureka/
    routes:
      - name: easypoi测试
        serviceName: service-easypoi
        location: /v2/api-docs?group=WEB接口文档1.0版本
        servicePath: /easypoi
      - name: kafka测试
        serviceName: service-kafka
        location: /v2/api-docs?group=WEB接口文档1.0版本
        servicePath: /kafka

Nacos注册中心聚合

Nacos的配置和Eureka几乎一模一样,唯一不同的区别是在yml进行配置的时候,使用的是knife4j.nacos开头,其他基本都是一样。

knife4j:
  enableAggregation: true
  nacos:
    enable: true
    serviceUrl: http://localhost:8848/
    routes:
      - name: easypoi测试
        serviceName: service-easypoi
        location: /v2/api-docs?group=WEB接口文档1.0版本
        servicePath: /easypoi
      - name: kafka测试
        serviceName: service-kafka
        location: /v2/api-docs?group=WEB接口文档1.0版本
        servicePath: /kafka

img
img

网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。

需要这份系统化资料的朋友,可以戳这里获取

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

😕/bbs.csdn.net/topics/618545628)**

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

  • 5
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值