You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by al...@apache.org on 2022/06/28 07:42:55 UTC

[dubbo-website] branch master updated: [fix] 优化分组聚合 (#1159)

This is an automated email from the ASF dual-hosted git repository.

albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 71a98808c9 [fix] 优化分组聚合 (#1159)
71a98808c9 is described below

commit 71a98808c92506142a4ad554bab760a351654c6e
Author: JIAN ZHONG <11...@qq.com>
AuthorDate: Tue Jun 28 15:42:51 2022 +0800

    [fix] 优化分组聚合 (#1159)
---
 .../rpc/group-merger.md                            | 33 +++++++++++++++++++---
 1 file changed, 29 insertions(+), 4 deletions(-)

diff --git a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/group-merger.md b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/group-merger.md
index ec66858c00..8a00dc969d 100644
--- a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/group-merger.md
+++ b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/rpc/group-merger.md
@@ -6,11 +6,18 @@ weight: 1
 description: "通过分组对结果进行聚合并返回聚合后的结果"
 ---
 
-通过分组对结果进行聚合并返回聚合后的结果,比如菜单服务,用group区分同一接口的多种实现,现在消费方需从每种group中调用一次并返回结果,对结果进行合并之后返回,这样就可以实现聚合菜单项。  
+## 特性说明
+通过分组对结果进行聚合并返回聚合后的结果,比如菜单服务,用group区分同一接口的多种实现,现在消费方需从每种group中调用一次并返回结果,对结果进行合并之后返回,这样就可以实现聚合菜单项。
 
 相关代码可以参考 [dubbo 项目中的示例](https://github.com/apache/dubbo-samples/tree/master/dubbo-samples-merge)
 
-## 配置
+#### 配置
+
+- 搜索所有分组
+- 合并指定分组
+
+## 使用场景
+## 使用方式
 
 搜索所有分组
 
@@ -40,9 +47,27 @@ description: "通过分组对结果进行聚合并返回聚合后的结果"
 </dubbo:reference>
 ```
 
-指定合并策略,缺省根据返回值类型自动匹配,如果同一类型有两个合并器时,需指定合并器的名称
+指定合并策略,缺省根据返回值类型自动匹配,如果同一类型有两个合并器时,需指定合并器的名称 [合并结果扩展](../../../reference-manual/spi/description/merger)
+
+```xml
+<dubbo:reference interface="com.xxx.MenuService" group="*">
+    <dubbo:method name="getMenuItems" merger="mymerge" />
+</dubbo:reference>
+
+```
+指定合并方法,将调用返回结果的指定方法进行合并,合并方法的参数类型必须是返回结果类型本身
+
+```xml
+<dubbo:reference interface="com.xxx.MenuService" group="*">
+    <dubbo:method name="getMenuItems" merger=".addAll" />
+</dubbo:reference>
+```
+
+#### 提示:
+从 `2.1.0` 版本开始支持
+
+
 
-{{% alert title="提示" color="primary" %}}
 参见:[合并结果扩展](../../../reference-manual/spi/description/merger)
 {{% /alert %}}