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 b9a7d4c fix dubbo tag document errors (#1055)
b9a7d4c is described below
commit b9a7d4ce20cf8994260419c3620b9f0ff0cc9277
Author: zhaoguhong <[email protected]>
AuthorDate: Wed Mar 23 07:42:41 2022 +0800
fix dubbo tag document errors (#1055)
---
content/en/docs/v2.7/user/examples/routing-rule.md | 10 +++++-----
content/zh/blog/releases/dubbo-go-1.5.1.md | 4 ++--
content/zh/docs/advanced/routing-rule-deprecated.md | 8 ++++----
content/zh/docs/advanced/routing-rule.md | 8 ++++----
content/zh/docsv2.7/user/examples/routing-rule-deprecated.md | 8 ++++----
content/zh/docsv2.7/user/examples/routing-rule.md | 2 +-
6 files changed, 20 insertions(+), 20 deletions(-)
diff --git a/content/en/docs/v2.7/user/examples/routing-rule.md
b/content/en/docs/v2.7/user/examples/routing-rule.md
index b9dc54b..08b9ae8 100644
--- a/content/en/docs/v2.7/user/examples/routing-rule.md
+++ b/content/en/docs/v2.7/user/examples/routing-rule.md
@@ -177,18 +177,18 @@ The application which configures no tag will be
considered as the default applic
### Consumer
```Java
-RpcContext.getContext().setAttachment(Constants.REQUEST_TAG_KEY,"red");
+RpcContext.getContext().setAttachment(Constants.TAG_KEY,"red");
```
-The scope of the `request.tag` is for each invocation, using the attachment to
pass the request tag. Note that the value stored in the attachment will be
passed continuously in a complete remote invocation, thanks to this feature, we
only need to set the tag at the beginning of a invocation.
+The scope of the `dubbo.tag` is for each invocation, using the attachment to
pass the request tag. Note that the value stored in the attachment will be
passed continuously in a complete remote invocation, thanks to this feature, we
only need to set the tag at the beginning of a invocation.
-> Currently, only **hardcoding** is supported to set requestTag. Note that
RpcContext is thread-bound, elegantly using the TagRouter feature, it is
recommended to set the request tag via a servlet filter (in the web
environment) or a custom dubbo SPI filter.
+> Currently, only **hardcoding** is supported to set dubboTag. Note that
RpcContext is thread-bound, elegantly using the TagRouter feature, it is
recommended to set the request tag via a servlet filter (in the web
environment) or a custom dubbo SPI filter.
### Rules:
-1. `request.tag=red` will firstlt choose the provider which configures as
`tag=red`. If there is no service corresponding to the request tag in the
cluster, it will downgrade to `tag=null` provider, seen as default provider。
+1. `dubbo.tag=red` will firstlt choose the provider which configures as
`tag=red`. If there is no service corresponding to the request tag in the
cluster, it will downgrade to `tag=null` provider, seen as default provider。
-2. when `request.tag=null`, only `tag=null` provider will be matched. Even if
there are services available in the cluster, the tags do not match, they cannot
be called. This is different from rule 1. Tagged invocation can be downgraded
to untagged services, but invocations that do not carry tags/carry other types
of tags can never be accessed other tag services.
+2. when `dubbo.tag=null`, only `tag=null` provider will be matched. Even if
there are services available in the cluster, the tags do not match, they cannot
be called. This is different from rule 1. Tagged invocation can be downgraded
to untagged services, but invocations that do not carry tags/carry other types
of tags can never be accessed other tag services.
diff --git a/content/zh/blog/releases/dubbo-go-1.5.1.md
b/content/zh/blog/releases/dubbo-go-1.5.1.md
index caec0c4..c7b9a9a 100644
--- a/content/zh/blog/releases/dubbo-go-1.5.1.md
+++ b/content/zh/blog/releases/dubbo-go-1.5.1.md
@@ -123,8 +123,8 @@ err := userProvider.GetUser(ctx, []interface{}{"A001"},
user)
##### 降级约定
-1. `request.tag=tag1` 时优先选择 标记了 `tag=tag1` 的
provider。若集群中不存在与请求标记对应的服务，默认将降级请求 tag 为空的 provider；如果要改变这种默认行为，即找不到匹配 tag1 的
provider 返回异常，需设置`request.tag.force=true`。
-2. `request.tag` 未设置时，只会匹配 tag 为空的 provider。即使集群中存在可用的服务，若 tag 不匹配也就无法调用，这与约定
1 不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
+1. `dubbo.tag=tag1` 时优先选择 标记了 `tag=tag1` 的 provider。若集群中不存在与请求标记对应的服务，默认将降级请求
tag 为空的 provider；如果要改变这种默认行为，即找不到匹配 tag1 的 provider
返回异常，需设置`dubbo.force.tag=true`。
+2. `dubbo.tag` 未设置时，只会匹配 tag 为空的 provider。即使集群中存在可用的服务，若 tag 不匹配也就无法调用，这与约定 1
不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
### 5.2 应用/服务级条件路由
diff --git a/content/zh/docs/advanced/routing-rule-deprecated.md
b/content/zh/docs/advanced/routing-rule-deprecated.md
index 4e92ff7..9268dd4 100644
--- a/content/zh/docs/advanced/routing-rule-deprecated.md
+++ b/content/zh/docs/advanced/routing-rule-deprecated.md
@@ -177,18 +177,18 @@ public ProviderConfig providerConfig(){
### 服务消费者
```Java
-RpcContext.getContext().setAttachment(Constants.REQUEST_TAG_KEY,"red");
+RpcContext.getContext().setAttachment(Constants.TAG_KEY,"red");
```
请求标签的作用域为每一次 invocation，使用 attachment 来传递请求标签，注意保存在 attachment
中的值将会在一次完整的远程调用中持续传递，得益于这样的特性，我们只需要在起始调用时，通过一行代码的设置，达到标签的持续传递。
-> 目前仅仅支持 hardcoding 的方式设置 requestTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 requestTag。
+> 目前仅仅支持 hardcoding 的方式设置 dubboTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 dubboTag。
### 规则描述
-1. request.tag=red 时优先选择 tag=red 的 provider。若集群中不存在与请求标记对应的服务，可以降级请求 tag=null
的 provider，即默认 provider。
+1. dubbo.tag=red 时优先选择 tag=red 的 provider。若集群中不存在与请求标记对应的服务，可以降级请求 tag=null 的
provider，即默认 provider。
-2. request.tag=null 时，只会匹配 tag=null 的 provider。即使集群中存在可用的服务，若 tag
不匹配就无法调用，这与规则1不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
+2. dubbo.tag=null 时，只会匹配 tag=null 的 provider。即使集群中存在可用的服务，若 tag
不匹配就无法调用，这与规则1不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
diff --git a/content/zh/docs/advanced/routing-rule.md
b/content/zh/docs/advanced/routing-rule.md
index 9313109..f9c1a1b 100644
--- a/content/zh/docs/advanced/routing-rule.md
+++ b/content/zh/docs/advanced/routing-rule.md
@@ -219,12 +219,12 @@ host != 172.22.3.* => host != 172.22.3.*
#### Consumer
```java
-RpcContext.getContext().setAttachment(Constants.REQUEST_TAG_KEY,"tag1");
+RpcContext.getContext().setAttachment(Constants.TAG_KEY,"tag1");
```
请求标签的作用域为每一次 invocation，使用 attachment 来传递请求标签，注意保存在 attachment
中的值将会在一次完整的远程调用中持续传递，得益于这样的特性，我们只需要在起始调用时，通过一行代码的设置，达到标签的持续传递。
-> 目前仅仅支持 hardcoding 的方式设置 requestTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 requestTag。
+> 目前仅仅支持 hardcoding 的方式设置 dubboTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 dubboTag。
@@ -245,9 +245,9 @@
RpcContext.getContext().setAttachment(Constants.REQUEST_TAG_KEY,"tag1");
#### 降级约定
-1. `request.tag=tag1` 时优先选择 标记了`tag=tag1` 的 provider。若集群中不存在与请求标记对应的服务，默认将降级请求
tag为空的provider；如果要改变这种默认行为，即找不到匹配tag1的provider返回异常，需设置`request.tag.force=true`。
+1. `dubbo.tag=tag1` 时优先选择 标记了`tag=tag1` 的 provider。若集群中不存在与请求标记对应的服务，默认将降级请求
tag为空的provider；如果要改变这种默认行为，即找不到匹配tag1的provider返回异常，需设置`dubbo.force.tag=true`。
-2. `request.tag`未设置时，只会匹配tag为空的provider。即使集群中存在可用的服务，若 tag
不匹配也就无法调用，这与约定1不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
+2. `dubbo.tag`未设置时，只会匹配tag为空的provider。即使集群中存在可用的服务，若 tag
不匹配也就无法调用，这与约定1不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
{{% alert title="提示" color="primary" %}}
`2.6.x` 版本以及更早的版本请使用[老版本路由规则](../routing-rule-deprecated)
diff --git a/content/zh/docsv2.7/user/examples/routing-rule-deprecated.md
b/content/zh/docsv2.7/user/examples/routing-rule-deprecated.md
index ff15eac..d596d2c 100644
--- a/content/zh/docsv2.7/user/examples/routing-rule-deprecated.md
+++ b/content/zh/docsv2.7/user/examples/routing-rule-deprecated.md
@@ -177,18 +177,18 @@ public ProviderConfig providerConfig(){
### 服务消费者
```Java
-RpcContext.getContext().setAttachment(Constants.REQUEST_TAG_KEY,"red");
+RpcContext.getContext().setAttachment(Constants.TAG_KEY,"red");
```
请求标签的作用域为每一次 invocation，使用 attachment 来传递请求标签，注意保存在 attachment
中的值将会在一次完整的远程调用中持续传递，得益于这样的特性，我们只需要在起始调用时，通过一行代码的设置，达到标签的持续传递。
-> 目前仅仅支持 hardcoding 的方式设置 requestTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 requestTag。
+> 目前仅仅支持 hardcoding 的方式设置 dubboTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 dubboTag。
### 规则描述
-1. request.tag=red 时优先选择 tag=red 的 provider。若集群中不存在与请求标记对应的服务，可以降级请求 tag=null
的 provider，即默认 provider。
+1. dubbo.tag=red 时优先选择 tag=red 的 provider。若集群中不存在与请求标记对应的服务，可以降级请求 tag=null 的
provider，即默认 provider。
-2. request.tag=null 时，只会匹配 tag=null 的 provider。即使集群中存在可用的服务，若 tag
不匹配就无法调用，这与规则1不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
+2. dubbo.tag=null 时，只会匹配 tag=null 的 provider。即使集群中存在可用的服务，若 tag
不匹配就无法调用，这与规则1不同，携带标签的请求可以降级访问到无标签的服务，但不携带标签/携带其他种类标签的请求永远无法访问到其他标签的服务。
diff --git a/content/zh/docsv2.7/user/examples/routing-rule.md
b/content/zh/docsv2.7/user/examples/routing-rule.md
index 47d42bb..b84be09 100644
--- a/content/zh/docsv2.7/user/examples/routing-rule.md
+++ b/content/zh/docsv2.7/user/examples/routing-rule.md
@@ -224,7 +224,7 @@
RpcContext.getContext().setAttachment(CommonConstants.TAG_KEY,"tag1");
请求标签的作用域为每一次 invocation，使用 attachment 来传递请求标签，注意保存在 attachment
中的值将会在一次完整的远程调用中持续传递，得益于这样的特性，我们只需要在起始调用时，通过一行代码的设置，达到标签的持续传递。
-> 目前仅仅支持 hardcoding 的方式设置 requestTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 requestTag。
+> 目前仅仅支持 hardcoding 的方式设置 dubboTag。注意到 RpcContext 是线程绑定的，优雅的使用 TagRouter
特性，建议通过 servlet 过滤器(在 web 环境下)，或者定制的 SPI 过滤器设置 dubboTag。
