This is an automated email from the ASF dual-hosted git repository. albumenj pushed a commit to branch 0719_add_doc2 in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
commit 9ee81c05afe9487d8f294711c34725d4e46c5103 Author: Albumen Kevin <[email protected]> AuthorDate: Tue Jul 19 14:50:45 2022 +0800 Add service docs --- .../service/consistent-hash.md | 47 ++++++++++++++++++++++ .../service/specify-ip.md | 2 +- .../service/streaming.md | 9 +++++ 3 files changed, 57 insertions(+), 1 deletion(-) diff --git a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/consistent-hash.md b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/consistent-hash.md new file mode 100644 index 0000000000..e5d7c31c6c --- /dev/null +++ b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/consistent-hash.md @@ -0,0 +1,47 @@ +--- +type: docs +title: "一致性哈希选址" +linkTitle: "一致性哈希选址" +weight: 6 +description: "在负载均衡阶段基于一致性哈希进行选址" +--- + +## 使用场景 + +在有多台服务端的时候根据请求参数的进行一致性哈希 [^1] 散列选择服务端。 + +## 使用方式 + +配置一致性哈希的方式有很多，最常见的是： + +注解： + +> @DubboReference(loadbalance = “consistenthash”) + +API 配置： + +> referenceConfig.setLoadBalance("consistenthash"); + +Properties配置： + +> dubbo.reference.loadbalance=consistenthash + +XML配置： + +> <dubbo:reference loadbalance=“consistenthash” /> + +默认采用第一个参数作为哈希 key，如果需要切换参数，可以指定 `hash.arguments` 属性，例如： + +```java +ReferenceConfig<DemoService> referenceConfig = new ReferenceConfig<DemoService>(); +// ... init +Map<String, String> parameters = new HashMap<String, String>(); +parameters.put("hash.arguments", "1"); +parameters.put("sayHello.hash.arguments", "0,1"); +referenceConfig.setParameters(parameters); +referenceConfig.setLoadBalance("consistenthash"); +referenceConfig.get(); +``` + +[^1]: [Dubbo 一致性Hash负载均衡实现剖析 +](https://dubbo.apache.org/zh/blog/2019/05/01/dubbo-%E4%B8%80%E8%87%B4%E6%80%A7hash%E8%B4%9F%E8%BD%BD%E5%9D%87%E8%A1%A1%E5%AE%9E%E7%8E%B0%E5%89%96%E6%9E%90/) \ No newline at end of file diff --git a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/specify-ip.md b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/specify-ip.md index 67aad2ede1..c54df35967 100644 --- a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/specify-ip.md +++ b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/specify-ip.md @@ -2,7 +2,7 @@ type: docs title: "指定 IP 调用" linkTitle: "运行时指定 IP 调用" -weight: 4 +weight: 5 description: "在发起 Dubbo 调用之前指定本次调用的目标 IP" --- diff --git a/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/streaming.md b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/streaming.md new file mode 100644 index 0000000000..86563e000e --- /dev/null +++ b/content/zh/docs3-building/java-sdk/advanced-features-and-usage/service/streaming.md @@ -0,0 +1,9 @@ +--- +type: docs +title: "流式通信" +linkTitle: "流式通信" +weight: 4 +description: "基于 Triple 协议进行流式通信" +--- + +TBD
