This is an automated email from the ASF dual-hosted git repository.
traky pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/apisix.git
The following commit(s) were added to refs/heads/master by this push:
new b4087e349 docs: update dubbo-proxy doc (#10822)
b4087e349 is described below
commit b4087e349145a0182cff3fdd9f23fa399f73f600
Author: Shehar Yaar <[email protected]>
AuthorDate: Tue Jan 16 08:57:24 2024 +0530
docs: update dubbo-proxy doc (#10822)
---
docs/en/latest/plugins/dubbo-proxy.md | 40 ++++++++++++++++++++++++++++++++++-
1 file changed, 39 insertions(+), 1 deletion(-)
diff --git a/docs/en/latest/plugins/dubbo-proxy.md
b/docs/en/latest/plugins/dubbo-proxy.md
index 9dc8e1930..7e09b0d59 100644
--- a/docs/en/latest/plugins/dubbo-proxy.md
+++ b/docs/en/latest/plugins/dubbo-proxy.md
@@ -93,7 +93,45 @@ curl http://127.0.0.1:9180/apisix/admin/routes/1 -H
'X-API-KEY: edd1c9f034335f1
You can follow the [Quick
Start](https://github.com/alibaba/tengine/tree/master/modules/mod_dubbo#quick-start)
guide in Tengine with the configuration above for testing.
-Dubbo returns data in the form `Map<String, String>`.
+APISIX dubbo plugin uses `hessian2` as the serialization protocol. It supports
only `Map<String, Object>` as the request and response data type.
+
+### Application
+
+Your dubbo config should be configured to use `hessian2` as the serialization
protocol.
+
+```yml
+dubbo:
+ ...
+ protocol:
+ ...
+ serialization: hessian2
+```
+
+Your application should implement the interface with the request and response
data type as `Map<String, Object>`.
+
+```java
+public interface DemoService {
+ Map<String, Object> sayHello(Map<String, Object> context);
+}
+```
+
+### Request and Response
+
+If you need to pass request data, you can add the data to the HTTP request
header. The plugin will convert the HTTP request header to the request data of
the Dubbo service. Here is a sample HTTP request that passes `user` information:
+
+```bash
+curl -i -X POST 'http://localhost:9080/hello' \
+ --header 'user: apisix'
+
+
+HTTP/1.1 200 OK
+Date: Mon, 15 Jan 2024 10:15:57 GMT
+Content-Type: text/plain; charset=utf-8
+...
+hello: apisix
+...
+Server: APISIX/3.8.0
+```
If the returned data is:
