# Dubbo-Knife4j-Gateway

**Repository Path**: wruins/dubbo-knife4j-gateway

## Basic Information

- **Project Name**: Dubbo-Knife4j-Gateway
- **Description**: 微服务场景下的knife4j聚合，项目用到Dubbo，Zookeeper，Eureka，Gateway，Knife4j。一起动手搭建吧。


- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2022-06-21
- **Last Updated**: 2022-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Knife4J, Dubbo

## README

# Dubbo-Knife4j-Gateway

#### 介绍
微服务场景下的knife4j聚合，项目用到Dubbo，Zookeeper，Eureka，Gateway，Knife4j。一起动手搭建吧。

这个仓库想法起源于公司项目为什么api文档和api调试需要自己下载软件，编写，自己测试。

建议在新项目搭建运行，不要自行在公司的主分支修改依赖，不要在已有项目嵌入。

公司的项目（dubbo，zookeeper）---添加组件（Eureka，Gateway,Knife4j）

Knife4j作用在单个服务文档简单，遇到微服务总不能一个ip/port一个文档吧，肯定是要把文档聚合在一个服务（网关）上。



#### 软件架构
![架构图](lib/image.png)


#### 搭建教程
1.  对于这种多种依赖冗杂的项目，第一时间要解决的问题就是依赖版本冲突的问题。目前提供以下兼容版本，其他版本请自行摸索（<span style="font-size: 15px">搭建5天，依赖就花了3天</span>）

| springboot     | dubbo（zookeeper） | knife4j | springcloud | swagger-models | swagger-annotations(强制) |
| -------------- | ------------------ | ------- | ----------- | -------------- | ------------------------- |
| 2.3.11.RELEASE | 2.7.9              | 3.0.3   | Hoxton.SR12 | 1.5.22         | 1.5.22                    |

<span style="font-size: 15px">注：swagger-annotations依赖必须强制1.5.22否则，会使用1.5.19，这个版本的@ApiResponse缺少example（我也没找到这个1.5.19从哪里来的，所以干脆父依赖覆盖）</span>

2. 具体依赖还是根据本项目示例的pom文件进行测试，有修改的地方请大家提出来。
3. 构建项目结构

![结构图](lib/img.png)