增加 authority 解释,补充 serverName 起始为斜杠时的要求 (#493)
							parent
							
								
									a5ac42ea17
								
							
						
					
					
						commit
						fdf8399092
					
				| 
						 | 
				
			
			@ -35,6 +35,7 @@ gRPC(HTTP/2)内置多路复用,不建议使用 gRPC 与 HTTP/2 时启用 m
 | 
			
		|||
 | 
			
		||||
```json
 | 
			
		||||
{
 | 
			
		||||
  "authority": "grpc.example.com",
 | 
			
		||||
  "serviceName": "name",
 | 
			
		||||
  "multiMode": false,
 | 
			
		||||
  "user_agent": "custom user agent",
 | 
			
		||||
| 
						 | 
				
			
			@ -45,13 +46,17 @@ gRPC(HTTP/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"`。
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue