增加 authority 解释,补充 serverName 起始为斜杠时的要求 (#493)

This commit is contained in:
ちか 2024-03-27 12:43:10 +08:00 committed by GitHub
parent a5ac42ea17
commit fdf8399092
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -35,6 +35,7 @@ gRPCHTTP/2内置多路复用不建议使用 gRPC 与 HTTP/2 时启用 m
```json
{
"authority": "grpc.example.com",
"serviceName": "name",
"multiMode": false,
"user_agent": "custom user agent",
@ -45,13 +46,17 @@ gRPCHTTP/2内置多路复用不建议使用 gRPC 与 HTTP/2 时启用 m
}
```
> `authority`: string
一个字符串,可以当 Host 来用,实现一些其它用途。
> `serviceName`: string
一个字符串,指定服务名称,**类似于** HTTP/2 中的 Path。
客户端会使用此名称进行通信,服务端会验证服务名称是否匹配。
::: tip
`serviceName` 起始为斜杠时可以自定义 path。<br>
`serviceName` 起始为斜杠时可以自定义 path,至少要两个斜杠<br>
例如在服务端填写 `"serviceName": "/my/sample/path1|path2"`,客户端可填写 `"serviceName": "/my/sample/path1"``"/my/sample/path2"`
:::