dubbo挪用php技巧_Dubbo 跨措辞调用神兽dubbogopixiu

Pixiu 是什么

在回答 Pixiu 是什么之前，我们大略阐明一下 Dubbo 是什么。
Dubbo 是一个开源的高性能 RPC 框架，有着丰富的做事管理能力以及精良的扩展能力。
Dubbo 更扩展出 Dubbo-go【1】，为用户供应了 Golang 的 Dubbo 办理方案，打通了两种措辞之间的隔阂，使 Dubbo 更加贴近云原生。

Dubbo-go 作为 Golang 做事，实现与 Dubbo 做事之间的相互调用。
然而，在日常利用场景中，用户每每有把 Dubbo 做事以 RESTful 风格向外暴露的需求同时也要兼顾内部 Dubbo 调用。
为理解决这种场景，作为 Dubbo API 网关的 Pixiu【2】 (中文: 貔貅， 曾用名 dubbo-go-proxy) 便应运而生。
之以是采取 Pixiu 这个名称，是由于 Java 同类产品 Zuul 的意象是一个西方怪兽，Pixiu 作为一个国产产品，就用了我们中国的一个类似的神兽貔貅作为项目名称。
也同时表达了 Dubbo 社区希望扩展出一整套云原生生态链的决心。

目前 Dubbo 多措辞生态，发展最好的自然是 Java，其次是 Golang，其他措辞都差强人意。
dubbo-go-pixiu 项目是一个基于 dubbo-go 发展起来的项目，目前接口协议层支持的是七层的 HTTP 要求调用，操持在未来的 0.5 版本中支持 gRPC 要求调用，其其余一个义务是作为一种新的 dubbo 多措辞办理方案。

Pixiu 是基于 Dubbogo 的云原生、高性能、可扩展的微做事 API 网关。
作为一款网关产品，Pixiu 帮助用户轻松创建、发布、掩护、监控和保护任意规模的 API ，接管和处理成千上万个并发 API 调用，包括流量管理、 CORS 支持、授权和访问掌握、限定、监控，以及 API 版本管理。
除此以外，作为 Dubbo 的衍生产品，Pixiu 可以帮助 Dubbo 用户进行协议转换，实现跨系统、跨协议的做事能力互通。

Pixiu 的整体设计遵守以下原则：

非 RESTful 风格的 API 和 Dubbo 协议的做事每每须要修正才可以以 RESTful API 风格对外开放。
Pixiu 供应协议转换功能，通过 Pixiu，开拓者可以将自己的 HTTP API 或 Dubbo API 通过配置，以 RESTful API 风格对外开放。
v0.2.1 版本已支持基于泛化调用的 HTTP 至 Dubbo 的协议转换以及 HTTP 协议的转发。
在后续的版本，社区将会增加对 gRPC 和 http2 协议的支持。

面向用户的配置办法

一样平常的网关的配置每每繁琐且繁芜。
Pixiu，目标作为一款易用的网关产品，在设计上拥有三层配置层级，Gateway 层全局配置， API resource 层配置以及 HTTP verbs 方法层配置。
通过三个不同层级的配置，既可以实现深度的定制，亦支持统一的默认配置；同时，支持本地的配置文件，亦可利用统一配置做事器。
其余，还供应掌握台模块，通过掌握台模块，支持配置的热更新。
Pixiu 配套配套的掌握台界面也在同步开拓中。

通用功能的集成

重试、熔断、流量掌握、访问掌握等通用功能不再须要在每个后端做事上重复实现。
利用 Pixiu，通过配置 filter ，开拓者可以进行全局的掌握，亦可以根据 API 配置各自的规则。
因此开拓者可以专注于业务逻辑和做事，而不是将韶光用在掩护根本举动步伐上。

可扩展

不同的利用场景有着各自独特的需求。
为知足不同用户的定制化需求，Pixiu 利用了插件模式。
开拓者可以通过编写 go plugin，将自身特有的业务逻辑以 filter 形式内嵌至 Pixiu 网关中，实现诸如企业登录鉴权等功能。

图 1: Pixiu 核心功能列表

图 2: Pixiu 架构

貔貅: 即 dubbo-go-pixiu，由四个紧张模块：Listener、Router、Filters 和 Clients 组成；

Dubbo Cluster: Dubbo 做事所在集群，包含一个或多个 Dubbo Services；

Other Cluster: Dubbo 以外的做事所在集群，现支持 HTTP 做事，未来将拓展支持 gRPC 等其他做事；

Registry Center: 注册中央，掩护每个业务做事的调用地址信息；

Metadata Center: 元数据中央，掩护每个业务做事的配置信息以及存储 Pixiu 本身的配置信息。

作为 Dubbo 所衍生的 API 网关，Pixiu 利用 Golang 搭建，紧张由于: 1. Golang 的 G-M-P，net poller 等特性使 Golang 非常适宜构建 IO 密集型运用；2. 利用 Golang 可以直接引入 Dubbo-go 中的一些组建，简化开拓。

全体 Pixiu 大致可以拆分为四个紧张模块：Listener、Router、Filters 和 Client。

1、Listener

在 Pixiu 中，Listener 代表外部可以访问 Pixiu 的办法。
通过配置指定协议类型，地址，端口等属性，暴露 Gateway。
现阶段暂支持 HTTP 协议，未来将会加入 gRPC。

listeners: - name: "net/http" address: socket_address: protocol_type: "HTTP" address: "0.0.0.0" port: 8888 config: idle_timeout: 5s read_timeout: 5s write_timeout: 5s

复制代码

2、Router

Router 是 Pixiu 的路由组件。
根据配置文件，Pixiu 将对外暴露的 URLs 以树的形势存储于内存中，当要求到了 router 组件时，即会根据 URL 及 HTTP 方法查找到对应的后端做事及其 API 配置，并将信息封装于要求中，为后续 filter，及 client 的调用供应足够的内容。

现阶段，Router 供应以下功能:

- 支持要求一对一转发路由配置或 wildcard 路由配置。

- 支持 HTTP 要求的转发到后端 HTTP 做事。

- 支持 HTTP 要求转化为 dubbo 泛化调用要求。

3、Filters

Filter 是 Pixiu 实现额外功能及其扩展性的紧张组件。
实在现类似于 Dubbo-go 中的 filter，根据配置中 filter 的指定，天生调用链，从而在调用后端做事前，将各 filter 中的逻辑运行一遍，实现节流，日志等功能。

用户如果须要客制化的 filter，可通过编写 go-plugin 实现。
在配置中，可通过类似如下配置，加载 .so 文件，并在 API config 中指定利用的 plugin group，plugin name 实现。

pluginFilePath: "" pluginsGroup: - groupName: "group1" plugins: - name: "rate limit" version: "0.0.1" priority: 1000 externalLookupName: "ExternalPluginRateLimit" - name: "access" version: "0.0.1" priority: 1000 externalLookupName: "ExternalPluginAccess" - groupName: "group2" plugins: - name: "blacklist" version: "0.0.1" priority: 1000 externalLookupName: "ExternalPluginBlackList"

复制代码

4、Client

Client 卖力调用详细做事。
现阶段，Pixiu 支持 HTTP 与 Dubbo 的后端做事。
社区将逐渐增加 gRPC 等其他 Client 以知足不同的协议。

HTTP client 的实现相对大略，根据 Router 中获取的后端做事信息，通过 Golang 官方包 net/http 天生要求并调用。

Dubbo client 的实现比拟 HTTP client 会轻微繁芜，其根本为 Dubbo 做事的泛化调用。
泛化调用技能是 Dubbo 供应的一个很根本的功能只须要知道调用的方法名、参数类型和返回值类型，即可发起做事调用。
客户端对做事真个泛化调用既可以通过注册中央创造做事，也可以直连做事端，实现对做事的动态调用。

如下面代码所示，Pixiu 通过动态配置 referenceConfig，然后通过 GetRPCService 天生 Dubbo 的 Generic Client（泛化调用客户端）进行下一步的调用。

referenceConfig := dg.NewReferenceConfig(irequest.Interface, context.TODO()) referenceConfig.InterfaceName = irequest.Interface referenceConfig.Cluster = constant.DEFAULT_CLUSTER var registers []string for k := range dgCfg.Registries { registers = append(registers, k) } referenceConfig.Registry = strings.Join(registers, ",") if len(irequest.DubboBackendConfig.Protocol) == 0 { referenceConfig.Protocol = dubbo.DUBBO } else { referenceConfig.Protocol = irequest.DubboBackendConfig.Protocol } referenceConfig.Version = irequest.DubboBackendConfig.Version referenceConfig.Group = irequest.Group referenceConfig.Generic = true if len(irequest.DubboBackendConfig.Retries) == 0 { referenceConfig.Retries = "3" } else { referenceConfig.Retries = irequest.DubboBackendConfig.Retries } dc.lock.Lock() defer dc.lock.Unlock() referenceConfig.GenericLoad(key) clientService := referenceConfig.GetRPCService().(dg.GenericService)

复制代码

实际上，在泛化调用的客户端中，实际实行泛化调用的关键步骤是 Dubbo-go 中的 generic_filter (如下代码片段)。
在调用 generic_filter 的 Invoke 时，约定 invocation 参数列表第一个为方法名，第二个为参数类型列表，第三个为参数值列表。
generic_filter 将用户要求的参数值列表转化为统一格式的 map（代码中的 struct2MapAll ），将类（ golang 中为 struct ）的正反序列化操作变成 map 的正反序列化操作。
这使得无需 POJO 描述通过硬编码注入 hessain 库，从而完成 Dubbo 做事的泛化调用。

func (ef GenericFilter) Invoke(ctx context.Context, invoker protocol.Invoker, invocation protocol.Invocation) protocol.Result { if invocation.MethodName() == constant.GENERIC && len(invocation.Arguments()) == 3 { oldArguments := invocation.Arguments() if oldParams, ok := oldArguments[2].([]interface{}); ok { newParams := make([]hessian.Object, 0, len(oldParams)) for i := range oldParams { newParams = append(newParams, hessian.Object(struct2MapAll(oldParams[i]))) } newArguments := []interface{}{ oldArguments[0], oldArguments[1], newParams, } newInvocation := invocation2.NewRPCInvocation(invocation.MethodName(), newArguments, invocation.Attachments()) newInvocation.SetReply(invocation.Reply()) return invoker.Invoke(ctx, newInvocation) } } return invoker.Invoke(ctx, invocation)}

复制代码

通过上面的四个模块以及注册中央的大略先容不难创造，当要求通过 listener 被 Pixiu 吸收后，要求被传入 router 中。
router 根据接口的配置，从原要求中找到目标后端做事连同干系 API 配置下发到 filter 组件。
filter 组件根据原要求、 API 配置等信息顺序实行，终极要求到达 client， 通过 client 调用后端做事。

图 3: Pixiu 迭代里程碑

Pixiu 作为网关产品外，其衍生项目也会在我们的未来操持中，紧张目的是供应更好的可用性。
例如，由于 Golang 措辞缺少原生的表明， 因此 Dubbo-go 须要通过配置文件办法天生做事的元数据写入注册中央。
开课啦教诲公司干系同学写了一个扫描代码的工具 https://github.com/jack15083/dubbo-go-proxy-tool，在每个 RPC 做事方法前加上对应的注释，从而在做事启动前通过扫描注释天生元数据。
Pixiu 也操持在未来的版本上通过供应 package，许可做事通过注释借助 https://github.com/MarcGrol/golangAnnotations 天生 API 配置并注册到 Pixiu 上。

Pixiu 目前的定位是一个七层协议网关，其最初版本是被定义成一个 Dubbo 的做事网关。
作为云时期的产品，Pixiu 的发展方向一定是面向云原生的。
现在的版本为 0.2.1, 已经实现基本的 Dubbo/Http 做事代理和部分的网关通用功能。
目前正在开拓中的 0.4 及其后续版本支持 gRPC 和 Spring Cloud 做事调用， 后续还将供应 MQ 做事支持。
其余，社区将连续优化配置办法，降落用户的利用难度，连续优化官方的 filter，使 Pixiu 可以在官方层面实现更多的网关通用功能。

在未来的一年内，社区操持支持 xDS API，将 Pixiu 蜕变为 Dubbo mesh 的 sidecar。
其终极目的便是：在现有的 dubbo mesh 形态中蜕变出 Proxy Service Mesh 形态。
基于这个形态，Js、Python、PHP、Ruby 和 Perl 等脚本措辞程序除了收成 dubbo mesh 原有的技能红利之外，大概率还能收成性能上的提升。

Pixiu 在 Dubbo Mesh 中的终极目的是：把东西向和南北向数据面流量逐步统一 Pixiu 中的同时，让它逐步具备 Application Runtime 的能力，作为 Dubbo 多措辞生态的关键办理方案。

干系链接：

【1】Dubbo-go：https://github.com/apache/dubbo-go

【2】Pixiu：https://github.com/apache/dubbo-go-pixiu