Skip to content

Commit 93f581a

Browse files
committed
Resolving comments: Line break and hyperlinks
1 parent b1c94d6 commit 93f581a

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

Documentation/grpc-metadata.md

+7-2
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,8 @@ Server side metadata sending and receiving examples are available [here](../exam
168168

169169
### Receiving metadata
170170

171-
To read metadata sent by the client, the server needs to retrieve it from RPC context using `FromIncomingContext`. Do not use `FromOutgoingContext` on server as it is for client-side only.
171+
To read metadata sent by the client, the server needs to retrieve it from RPC
172+
context using [FromIncomingContext](https://pkg.go.dev/google.golang.org/grpc/metadata#FromIncomingContext).
172173
If it is a unary call, the RPC handler's context can be used.
173174
For streaming calls, the server needs to get context from the stream.
174175

@@ -211,7 +212,7 @@ func (s *server) SomeRPC(ctx context.Context, in *pb.someRequest) (*pb.someRespo
211212

212213
#### Streaming call
213214

214-
For streaming calls, header and trailer can be sent using function `SendHeader` and `SetTrailer` in interface [ServerStream](https://godoc.org/google.golang.org/grpc#ServerStream):
215+
For streaming calls, header and trailer can be sent using function [SendHeader](https://godoc.org/google.golang.org/grpc#SendHeader) and [SetTrailer](https://godoc.org/google.golang.org/grpc#SetTrailer) in interface [ServerStream](https://godoc.org/google.golang.org/grpc#ServerStream):
215216

216217
```go
217218
func (s *server) SomeStreamingRPC(stream pb.Service_SomeStreamingRPCServer) error {
@@ -224,6 +225,10 @@ func (s *server) SomeStreamingRPC(stream pb.Service_SomeStreamingRPCServer) erro
224225
}
225226
```
226227

228+
Do not use
229+
[FromOutgoingContext](https://pkg.go.dev/google.golang.org/grpc/metadata#FromOutgoingContext) on the server to write metadata to be sent to the client.
230+
[FromOutgoingContext](https://pkg.go.dev/google.golang.org/grpc/metadata#FromOutgoingContext) is for client-side use only.
231+
227232
## Updating metadata from a server interceptor
228233

229234
An example for updating metadata from a server interceptor is

0 commit comments

Comments
 (0)