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 96c1946a762 Update simplify-registry-data.md (#1782)
96c1946a762 is described below

commit 96c1946a7622305361e21c29bfe35b4eacfa2f38
Author: mfordjody <[email protected]>
AuthorDate: Fri Dec 30 16:16:37 2022 +0800

    Update simplify-registry-data.md (#1782)
---
 .../performance/simplify-registry-data.md          | 112 +++++++++++----------
 1 file changed, 61 insertions(+), 51 deletions(-)

diff --git 
a/content/zh/docs3-v2/java-sdk/advanced-features-and-usage/performance/simplify-registry-data.md
 
b/content/zh/docs3-v2/java-sdk/advanced-features-and-usage/performance/simplify-registry-data.md
index 0f470feb864..dcdc8742a7f 100644
--- 
a/content/zh/docs3-v2/java-sdk/advanced-features-and-usage/performance/simplify-registry-data.md
+++ 
b/content/zh/docs3-v2/java-sdk/advanced-features-and-usage/performance/simplify-registry-data.md
@@ -14,16 +14,16 @@ Dubbo provider 中的服务配置项有接近 [30 个配置项](/zh/docs/referen
 Dubbo consumer 中的配置项也有 
[20+个配置项](/zh/docs/references/xml/dubbo-consumer)。在注册中心之中,服务消费者列表中只需要关注 
application,version,group,ip,dubbo 版本等少量配置,其他配置也可以以 key-value 形式持久化存储。    
 这些数据是以服务为维度注册进入注册中心,导致了数据量的膨胀,进而引发注册中心 (如 zookeeper) 的网络开销增大,性能降低。
 
-#### 设计目标和宗旨
-期望简化进入注册中心的 provider 和 consumer 配置数量。  
-期望将部分配置项以其他形式存储。这些配置项需要满足:不在服务调用链路上,同时这些配置项不在注册中心的核心链路上(服务查询,服务列表)。
+> 设计目标和宗旨 
+ 
+1. 期望简化进入注册中心的 provider 和 consumer 配置数量。
+2. 期望将部分配置项以其他形式存储。这些配置项需要满足:不在服务调用链路上,同时这些配置项不在注册中心的核心链路上(服务查询,服务列表)。
 
-#### 配置
 
-简化注册中心的配置,只在 2.7 之后的版本中进行支持。  
-开启 provider 或者 consumer 简化配置之后,默认保留的配置项如下:
+> 简化注册中心的配置,只在 2.7 之后的版本中进行支持。  
+  开启 provider 或者 consumer 简化配置之后,默认保留的配置项
 
-provider:
+**provider**
 
 | Constant Key  | Key           | remark |  
 | ------ |---------------| ------ |  
@@ -48,7 +48,7 @@ provider:
 | SIDE_KEY | side          |  |  
 
 
-consumer:
+**consumer**
 
 | Constant Key  | Key  | remark |  
 | ------ | ------ | ------ |  
@@ -71,7 +71,7 @@ Constant Key 表示来自于类 org.apache.dubbo.common.Constants 的字段。
 
 参考 sample 子工程: 
dubbo-samples-simplified-registry/dubbo-samples-simplified-registry-nosimple (跑 
sample 前,先跑下 ZKClean 进行配置项清理)
 
-##### dubbo-provider.xml 配置:
+### dubbo-provider.xml
 
 ```
 <dubbo:application name="simplified-registry-nosimple-provider"/>
@@ -82,27 +82,38 @@ Constant Key 表示来自于类 org.apache.dubbo.common.Constants 的字段。
                executes="4500" retries="7" owner="vict" timeout="5300"/>
 ```
 
-启动 provider 的 main 方法之后,查看 zookeeper 
的叶子节点(路径为:/dubbo/org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService/providers
 目录下)的内容如下:
+启动 provider 的 main 方法之后,查看 zookeeper 
的叶子节点(路径为:/dubbo/org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService/providers
 目录下)的内容
 
 ```
-dubbo%3A%2F%2F30.5.124.158%3A20880%2Forg.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService
-%3Fanyhost%3Dtrue%26application%3Dsimplified-registry-xml-provider%26async%3Dtrue%26dubbo%3D
-2.0.2%26executes%3D4500%26generic%3Dfalse%26group%3Ddubbo-simple%26interface%3D
-org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService%26methods%3D
-sayHello%26owner%3Dvict%26pid%3D2767%26retries%3D7%26revision%3D1.2.3%26side%3D
-provider%26timeout%3D5300%26timestamp%3D1542361152795%26valid%3Dtrue%26version%3D1.2.3
+dubbo://30.5.124.158:20880/org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService
+?anyhost=true
+&application=simplified-registry-xml-provider
+&async=true
+&dubbo=2.0.2
+&executes=4500
+&generic=false
+&group=dubbo-simple
+&interface=org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService
+&methods=sayHello
+&owner=vict
+&pid=2767
+&retries=7
+&revision=1.2.3
+&side=provider
+&timeout=5300
+&timestamp=1542361152795
+&valid=true
+&version=1.2.3
 ```
 
 从中能看到有:`executes`, `retries`, `owner`, `timeout`。但是这些字段不是每个都需要传递给 dubbo ops 或者 
dubbo consumer。 同样的,consumer 也有这个问题,可以在例子中启动 Consumer 的 main 方法进行查看。
 
 
 
-### 方式1. 配置 dubbo.properties
+### 1. dubbo.properties
 
 sample 在 
dubbo-samples-simplified-registry/dubbo-samples-simplified-registry-xml 工程下 (跑 
sample 前,先跑下ZKClean 进行配置项清理)
 
-##### dubbo.properties
-
 ```properties
 dubbo.registry.simplified=true  
 dubbo.registry.extra-keys=retries,owner  
@@ -112,11 +123,7 @@ dubbo.registry.extra-keys=retries,owner
 * 配置:dubbo.registry.simplified=true, 默认情况下,timeout 在默认的配置项列表,所以还是会进入注册中心;
 * 配置:dubbo.registry.extra-keys=retries,owner , 所以 retries,owner 也会进入注册中心。
 
-配置类型:
-- provider 端配置
-- consumer 端配置
-
-#### provider 端配置:
+### provider 端
 
 ```xml
 <beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
@@ -133,14 +140,20 @@ dubbo.registry.extra-keys=retries,owner
 
 </beans>
 ```
-得到的 zookeeper 的叶子节点的值:
+得到的 zookeeper 的叶子节点的值
 ```
-dubbo%3A%2F%2F30.5.124.149%3A20880%2Forg.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService%3F
-application%3Dsimplified-registry-xml-provider%26dubbo%3D2.0.2%26group%3Ddubbo-simple%26owner%3D
-vict%26retries%3D7%26timeout%3D5300%26timestamp%3D1542594503305%26version%3D1.2.3
+dubbo://30.5.124.149:20880/org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService
+?application=simplified-registry-xml-provider
+&dubbo=2.0.2
+&group=dubbo-simple
+&owner=vict
+&retries=7
+&timeout=5300
+&timestamp=1542594503305
+&version=1.2.3
 ```
 
-#### consumer 端配置
+### consumer 端
 * 配置:dubbo.registry.simplified=true
 * 默认情况:application,version,group,dubbo 在默认的配置项列表,所以还是会进入注册中心。
 ```xml
@@ -160,30 +173,31 @@ 
vict%26retries%3D7%26timeout%3D5300%26timestamp%3D1542594503305%26version%3D1.2.
 
 </beans>
 ```
-得到的 zookeeper 的叶子节点的值:
+得到的 zookeeper 的叶子节点的值
 ```
-consumer%3A%2F%2F30.5.124.149%2Forg.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService%3F
-actives%3D6%26application%3Dsimplified-registry-xml-consumer%26category%3D
-consumers%26check%3Dfalse%26dubbo%3D2.0.2%26group%3Ddubbo-simple%26owner%3Dvvv%26version%3D1.2.3
+consumer://30.5.124.149/org.apache.dubbo.samples.simplified.registry.nosimple.api.DemoService
+?actives=6
+&application=simplified-registry-xml-consumer
+&category=consumers
+&check=false
+&dubbo=2.0.2
+&group=dubbo-simple
+&owner=vvv
+&version=1.2.3
 ```
 
-### 方式2. 配置声明 spring bean
+### 2.声明 spring bean
 
-sample 在 
dubbo-samples-simplified-registry/dubbo-samples-simplified-registry-annotation 
工程下 (跑 sample 前,先跑下ZKClean 进行配置项清理)
+sample 在 
dubbo-samples-simplified-registry/dubbo-samples-simplified-registry-annotation 
工程下 (跑 sample 前,先跑下 ZKClean 进行配置项清理)
 
 和上面 sample 中的 dubbo.properties 的效果是一致的。
 
 * 默认情况:timeout 在默认的配置项列表,所以还是会进入注册中心;
 * 配置: retries,owner 作为额外的 key 进入注册中心 , 所以 retries,owner 也会进入注册中心。
 
-配置类型:
-
-- Provider 配置
-- Consumer 配置
+### Provider 配置
 
-#### Provider 配置
-
-##### privide 端 bean 配置:
+#### privider 端 bean 配置
 ```java
 // 等同于dubbo.properties配置,用@Bean形式进行配置
 @Bean
@@ -207,13 +221,13 @@ public class AnnotationServiceImpl implements 
AnnotationService {
     }
 }
 ```
-#### Consumer 配置
+### Consumer 配置
 
 和上面 sample 中 **consumer 端配置** 是一样的。
 
 默认情况:  application,version,group,dubbo 在默认的配置项列表,所以还是会进入注册中心。
 
-##### consumer 端 bean 配置:
+#### consumer 端 bean 配置
 ```java
 @Bean
 public RegistryConfig registryConfig() {
@@ -224,7 +238,7 @@ public RegistryConfig registryConfig() {
   }
 ```
 
-消费服务:  
+消费服务
 
 ```java
 @Component("annotationAction")
@@ -237,8 +251,7 @@ public class AnnotationAction {
     }
 }
 ```
-####  注意:
-如果一个应用中既有 provider 又有 consumer,那么配置需要合并成:
+> 注意: 如果一个应用中既有 provider 又有 consumer,那么配置需要合并成如下
 ```java
 @Bean
 public RegistryConfig registryConfig() {
@@ -250,7 +263,4 @@ public RegistryConfig registryConfig() {
     return registryConfig;
 }
 ```
-
-#### 提示:
-
- 本版本还保留了大量的配置项,接下来的版本中,会逐渐删除所有的配置项。
+> 提示:本版本还保留了大量的配置项,接下来的版本中,会逐渐删除所有的配置项。

Reply via email to