In general, gRPC-go provides a concurrency-friendly API. What follows are some guidelines.
A ClientConn can safely be accessed concurrently. Using helloworld as an example, one could share the ClientConn
across multiple goroutines to create multiple GreeterClient
types. In this case, RPCs would be sent in parallel. GreeterClient
, generated from the proto definitions and wrapping ClientConn
, is also concurrency safe, and may be directly shared in the same way. Note that, as illustrated in the multiplex example, other Client
types may share a single ClientConn
as well.
When using streams, one must take care to avoid calling either SendMsg
or RecvMsg
multiple times against the same Stream from different goroutines. In other words, it's safe to have a goroutine calling SendMsg
and another goroutine calling RecvMsg
on the same stream at the same time. But it is not safe to call SendMsg
on the same stream in different goroutines, or to call RecvMsg
on the same stream in different goroutines.
Each RPC handler attached to a registered server will be invoked in its own goroutine. For example, SayHello will be invoked in its own goroutine. The same is true for service handlers for streaming RPCs, as seen in the route guide example here. Similar to clients, multiple services can be registered to the same server.