docs: update the multi-service doc(zh) (#1006)

content/en/docs/kitex/Tutorials/advanced-feature/multi_service.md

@@ -102,8 +102,8 @@ Response sameNamedMethod(1: Request req)
 In this case, **please note that you need to specify one service as a fallback service.**
 
 Fallback service is used to maintain compatibility when the client is using an old Kitex version (< v0.9.0) 
-or when `TTHeader` is not being used for transport protocol, 
-or the client does not set an optional meta handler `transmeta.ClientTTHeaderHandler()`.
+- or when `TTHeader` is not being used for transport protocol, 
+- or the client does not set an optional meta handler `transmeta.ClientTTHeaderHandler()`.
 
 If you don't specify any fallback service or if you specify multiple fallback services, an error will be returned on server startup.
 

content/zh/docs/kitex/Tutorials/advanced-feature/multi_service.md

@@ -1,89 +1,146 @@
 ---
 title: "单 Server 多 Service"
-date: 2023-11-30
+date: 2023-03-05
 weight: 10
-keywords: ["Kitex", "多 Service", "单端口多Service", "gRPC"]
-description: Kitex 支持在一个 Server 上注册多个 Service。
+keywords: ["Kitex", "多 Service", "单 Server 多 Service", "gRPC", "thrift", "protobuf"]
+description: Kitex 支持在一个 Server 上注册多个 Service 。
 ---
 
-注：当前这个功能仅支持 **gRPC** 传输协议。
+目前，该功能适用于：
+- gRPC 传输协议
+- Kitex Thrift 和 Protobuf(non-streaming)
 
-## 使用
 
-### gRPC service 定义
+## 使用方法
 
-例如，假设您有两个 proto 文件（如下所示），每个包含一个 service。
-通过执行 kitex 命令，可以自动生成对应的代码。
+### 准备工作
+请使用 Kitex 命令工具为每个 Service 生成代码。更多详情，请参考[代码生成工具](https://www.cloudwego.io/docs/kitex/tutorials/code-gen/code_generation/).
 
-```protobuf
-// File1：servicea.proto
-syntax = "proto3";
+代码生成的结果如下所示：
 
-option go_package = "myservice";
-
-package myservice;
-
-service ServiceA {
-  rpc EchoA (stream RequestA) returns (stream ReplyA) {}
+```text
+kitex_gen
+    |_ api
+        |_ servicea
+            |_ client.go
+            |_ invoker.go
+            |_ server.go
+            |_ servicea.go
+        |_ serviceb
+            |_ client.go
+            |_ invoker.go
+            |_ server.go
+            |_ serviceb.go
+        |_ ...
+```
+您可以在每个 Service 的`server.go`中看到`RegisterService`函数。
+```golang
+func RegisterService(svr server.Server, handler XXX, opts ...server.RegisterOption) error {
+   if err := svr.RegisterService(serviceInfo(), handler, opts...); err != nil {
+      return err
+   }
+   return nil
 }
+```
 
-message RequestA {
-  ...
-}
+### 创建 Server 并在 Server 上注册您的 Service 
+在 Server 上注册 Service 是一个简单的过程。
 
-message ReplyA {
-  ...
-}
+首先，创建一台 Server 。然后，通过在您生成的代码中调用`RegisterService`函数，即可注册 Service 。
 
+可以在同一台 Server 上调用多个 Service ，根据需要注册任意多个 Service 。
 
-// File2：serviceb.proto
-syntax = "proto3";
+```golang
+package main
 
-option go_package = "myservice";
+import (
+   "github.com/cloudwego/kitex/pkg/server"
+
+    servicea "your_servicea_kitex_gen_path"
+    serviceb "your_serviceb_kitex_gen_path"
+)   
 
-package myservice;
+func main() {
+    // 通过调用 server.NewServer 创建 Server 
+    svr := server.NewServer(your_server_option)
+    // 在 Server 上注册多 Service
+    err := servicea.RegisterService(svr, new(ServiceAImpl))
+    err = serviceb.RegisterService(svr, new(ServiceBImpl))
+
+    err = svr.Run()
+
+    if err != nil {
+       logs.Error("%s", err.Error())
+    }
+    logs.Stop()
+}
+```
 
-service ServiceB {
-  rpc EchoB (stream RequestB) returns (stream ReplyB) {}
+### 备用 Service 
+假设 Service 之间有相同的命名方法。
+
+```thrift
+// demo.thrift
+namespace go api
+struct Request {
+1: string message
 }
 
-message RequestB {
-  ...
+struct Response {
+1: string message
 }
 
-message ReplyB {
-  ...
+service ServiceA {
+Response sameNamedMethod(1: Request req)
+}
+service ServiceB {
+Response sameNamedMethod(1: Request req)
 }
 ```
 
-### 如何在一个 Server 上注册多个 Service
+在这种情况下，**请注意，您需要指定一个 Service 作为备用 Service 。**
+
+当客户端使用旧的 Kitex 版本 ( < v0.9.0 ) 时，备用 Service 用于维护兼容性
+- 或者当`TTHeader`未用于传输协议时，
+- 或者客户端没有设置可选的元处理程序`Transmeta.ClientTTHeaderHandler()`。
 
-在一个 server 上注册多个 service 是一个简单的过程。
+如果未指定任何回退 Service 或指定了多个回退 Service ，则在 Server 启动时将返回错误。
 
-首先，创建一个 server。然后，通过调用该 server 上的 `RegisterService` 函数，就可以注册 service 了。
+请注意，您只能将一个 Service 指定为备用 Service 。
+
+生成代码(`server.go`)中的`RegisterService()`有一个可选参数：`server.RegisterOption`。
+如果传入`server.WithFallback Service`选项，则该 Service 将注册为回退 Service 。
 
 ```golang
-package main
+func main() {
+    // 通过调用 server.NewServer 创建 Server 
+    svr := server.NewServer(your_server_option)
+    // 在 Server 上注册多 Service 
+    // servicea 将成为备用 Service 
+    servicea.RegisterService(svr, new(ServiceAImpl), server.WithFallbackService())
+    serviceb.RegisterService(svr, new(ServiceBImpl))
+
+    err := svr.Run()
+    if err != nil {
+        logs.Error("%s", err.Error())
+    }
+    logs.Stop()
+}
+```
 
-import (
-   "github.com/cloudwego/kitex/pkg/server"
+另一种避免 Server 启动错误而不指定回退 Service 的方法是使用`server.WithRefuseTrafficWithoutServiceName`选项。
 
-   servicea "your_servicea_kitex_gen_path"
-   serviceb "your_serviceb_kitex_gen_path"
-)
+使用此选项，即使您没有为名称冲突的方法指定回退 Service ，启动 Server 时也不会返回错误。
 
-func main() {
-   // create a server by calling server.NewServer
-   svr := server.NewServer(your_server_option)
-   // register multi-service on a server
-   err := svr.RegisterService(servicea.NewServiceInfo(), new(ServiceAImpl))
-   err := svr.RegisterService(serviceb.NewServiceInfo(), new(ServiceBImpl))
+但在使用此选项时，必须注意以下事项：
 
-   err := svr.Run()
+当`server.WithRefuseTrafficWithoutServiceName`选项启用时，如果 Server 在以下情况下收到请求，
+则会出现错误消息：“no service name while the server has WithRefuseTrafficWithoutServiceName option enabled”
 
-   if err != nil {
-      logs.Error("%s", err.Error())
-   }
-   logs.Stop()
-}
-```
+- 客户端使用较旧的 Kitex 版本(<v0.9.0)，不支持多 Service 功能
+- 请求的传输协议不是 TTHeader ( Kitex pb 的传输协议默认启用 TTHeader )
+
+### 组合 Service 
+请注意，如果您注册了组合 Service (代码是使用 -combine-service 标志生成的)，
+**一台 Server 上只能注册一个 Service (= 组合 Service )**。
+否则，您将收到一条错误消息，提示您 "only one service can be registered when registering combined service" 。