《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的是Java Reactor 开发的响应式 API 网关——ShenYu。

Apache ShenYu 一款使用 Java Reactor 开发的响应式 API 网关。以其高性能，动态灵活的流量管控，热插拔，易部署等特性，开箱即用为用户提供整套全生命周期的 API 网关，包含 API 注册、服务代理、协议转换与 API 治理等功能。

功能特性

支持各种语言(http 协议)，支持 Dubbo、 Spring Cloud、 gRPC、 Motan、 Sofa、 Tars 等协议
插件化设计思想，插件热插拔，易扩展
灵活的流量筛选，能满足各种流量控制
内置丰富的插件支持，鉴权，限流，熔断，防火墙等等
流量配置动态化，性能极高
支持集群部署，支持 A/B Test，蓝绿发布

架构

脑图

模块

shenyu-admin : 插件和其他信息配置的管理后台
shenyu-bootstrap : 用于启动项目，用户可以参考
shenyu-client : 用户可以使用 Spring MVC，Dubbo，Spring Cloud 快速访问
shenyu-disruptor : 基于disruptor的封装
shenyu-register-center : shenyu-client提供各种rpc接入注册中心的支持
shenyu-common : 框架的通用类
shenyu-dist : 构建项目
shenyu-metrics : prometheus（普罗米修斯）实现的 metrics
shenyu-plugin : ShenYu 支持的插件集合
shenyu-spi : 定义 ShenYu spi
shenyu-spring-boot-starter : 支持 spring boot starter
shenyu-sync-data-center : 提供 ZooKeeper，HTTP，WebSocket，Nacos 的方式同步数据
shenyu-examples : RPC 示例项目
shenyu-web : 包括插件、请求路由和转发等的核心处理包

快速启动

运行ShenYu管理员：

> docker pull apache/shenyu-admin
> docker network create shenyu
> docker run -d -p 9095:9095 --net shenyu apache/shenyu-admin

运行引导程序：

> docker network create shenyu
> docker pull apache/shenyu-bootstrap
> docker run -d -p 9195:9195 --net shenyu apache/shenyu-bootstrap

设置路由器：

真实请求： http: //127.0.0.1 :8080/helloworld

{
  "name" : "Shenyu",
  "data" : "hello world"
}

设置路由规则

添加localKey: 123456到header。如果需要自定义localKey，可以使用sha512工具根据明文生成key并更新shenyu.local.sha512Key属性。

curl --location --request POST 'http://localhost:9195/shenyu/plugin/selectorAndRules' \
--header 'Content-Type: application/json' \
--header 'localKey: 123456' \
--data-raw '{
    "pluginName": "divide",
    "selectorHandler": "[{\"upstreamUrl\":\"127.0.0.1:8080\"}]",
    "conditionDataList": [{
        "paramType": "uri",
        "operator": "match",
        "paramValue": "/**"
    }],
    "ruleDataList": [{
        "ruleHandler": "{\"loadBalance\":\"random\"}",
        "conditionDataList": [{
            "paramType": "uri",
            "operator": "match",
            "paramValue": "/**"
        }]
    }]
}'

代理请求：http://localhost:9195/helloworld

{
  "name" : "Shenyu",
  "data" : "hello world"
}

数据缓存和数据同步

由于所有数据都已在 JVM 中使用 ConcurrentHashMap 进行缓存，因此速度非常快。

当用户在后台管理中更改配置信息时，Apache ShenYu 通过监听 ZooKeeper 节点（或 WebSocket 推送、HTTP 长轮询）来动态更新缓存。

—END—

开源协议：Apache2.0

开源地址：
https://github.com/apache/shenyu