08/14/2022
In the this series of posts I will look into the details of gRPC in ASP.NET Core. In the previous post I created a simple service and a corresponding client. In this posts I will focus on the internal implementation of ASP.NET Core's gRPC extension. gRPC (gRPC Remote Procedure Calls is an open source remote procedure call implementation that is based on modern (web) standards. gRPC leverages HTTP2 as transport protocol, and uses Protocol Buffer as a data format and interface definition language. It is typically used for back channel (service-to-service) communication due to its efficiency. However, the efficiency comes at a cost: debugging/decoding messages are not as straightforward as with other protocols.
The Internals
In this post I will look into how Grpc.AspNetCore nuget package handles gRPC requests. As mentioned in the previous post, the package includes tooling, that generates the base service code for the our real service implementation. During startup AddGrpc()
registers dependencies to the DI container, but there is only a handful of classes registered today. The main activity happens during mapping the service with MapGrpcService<T>()
call.
Internally this method creates the HTTP call handlers for the service method. Firstly, this method checks if the AddGrpc()
call has registered the service dependencies, and delegates the rest of the work to ServiceRouteBuilder<T>
. ServiceRouteBuilder<T>
is responsible for creating the ASP.NET Core endpoints, which has to be done before app.Run();
is called in Program.cs.
Find out more