dubbo-proxy
#
Descriptiondubbo-proxy plugin allows you proxy HTTP request to dubbo.
#
RequirementIf you are using OpenResty, you need to build it with dubbo support, see how to build
#
Runtime AttributesName | Type | Requirement | Default | Valid | Description |
---|---|---|---|---|---|
service_name | string | required | dubbo provider service name | ||
service_version | string | required | dubbo provider service version | ||
method | string | optional | the path of uri | dubbo provider service method |
#
Static AttributesName | Type | Requirement | Default | Valid | Description |
---|---|---|---|---|---|
upstream_multiplex_count | number | required | 32 | >= 1 | the maximum number of multiplex requests in an upstream connection |
#
How To EnableFirst of all, enable the dubbo-proxy plugin in the config.yaml
:
# Add this in config.yaml
plugins:
- ... # plugin you need
- dubbo-proxy
Then reload APISIX.
Here's an example, enable the dubbo-proxy plugin on the specified route:
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
}'
#
Test PluginYou can follow the Quick Start example in Tengine and use the configuration above to test it. They should provide the same result.
The returned data from upstream dubbo service must be a Map<String, String>
.
If the returned data is
{
"status": "200",
"header1": "value1",
"header2": "valu2",
"body": "blahblah"
}
the converted HTTP response will be
HTTP/1.1 200 OK # "status" will be the status code
...
header1: value1
header2: value2
...
blahblah # "body" will be the body
#
Disable PluginWhen you want to disable the dubbo-proxy plugin on a route/service, it is very simple, you can delete the corresponding json configuration in the plugin configuration, no need to restart the service, it will take effect immediately:
$ 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
}
}'
The dubbo-proxy plugin has been disabled now. It works for other plugins.
If you want to disable dubbo-proxy plugin totally,
you need to comment out in the config.yaml
:
plugins:
- ... # plugin you need
#- dubbo-proxy
And then reload APISIX.