dubbo-proxy
#
描述dubbo-proxy
插件允许将 HTTP
请求代理到 dubbo。
#
要求如果你正在使用 OpenResty
, 你需要编译它来支持 dubbo
, 参考 如何编译。
#
运行时属性名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
---|---|---|---|---|---|
service_name | string | 必选 | dubbo 服务名字 | ||
service_version | string | 必选 | dubbo 服务版本 | ||
method | string | 可选 | uri 路径 | dubbo 服务方法 |
#
静态属性名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
---|---|---|---|---|---|
upstream_multiplex_count | number | 必选 | 32 | >= 1 | 上游连接中最大的多路复用请求数 |
#
如何启用首先,在 config.yaml
中启用 dubbo-proxy
插件:
# Add this in config.yaml
plugins:
- ... # plugin you need
- dubbo-proxy
然后重载 APISIX
。
这里有个例子,在指定的路由中启用 dubbo-proxy
插件:
curl http://127.0.0.1:9080/apisix/admin/upstreams/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"nodes": {
"127.0.0.1:20880": 1
},
"type": "roundrobin"
}'
curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"uris": [
"/hello"
],
"plugins": {
"dubbo-proxy": {
"service_name": "org.apache.dubbo.sample.tengine.DemoService",
"service_version": "0.0.0",
"method": "tengineDubbo"
}
},
"upstream_id": 1
}'
#
测试插件你可以在 Tengine
提供的 快速开始 例子中使用上述配置进行测试。
将会有同样的结果。
从上游 dubbo
服务返回的数据一定是 Map<String, String>
类型。
如果返回的数据如下
{
"status": "200",
"header1": "value1",
"header2": "valu2",
"body": "blahblah"
}
则对应的 HTTP
响应如下
HTTP/1.1 200 OK # "status" will be the status code
...
header1: value1
header2: value2
...
blahblah # "body" will be the body
#
禁用插件当你想在某个路由或服务中禁用 dubbo-proxy
插件,非常简单,你可以直接删除插件配置中的 json
配置,不需要重启服务就能立即生效:
$ curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"methods": ["GET"],
"uris": [
"/hello"
],
"plugins": {
},
"upstream_id": 1
}
}'
现在 dubbo-proxy
插件就已经被禁用了。 此方法同样适用于其他插件。
如果你想彻底禁用 dubbo-proxy
插件,
你需要在 config.yaml
中注释掉以下内容:
plugins:
- ... # plugin you need
#- dubbo-proxy
然后重新加载 APISIX
。