The Ultimate Guide to gRPC in ASP.NET Core/

...

/

Creating a Basic gRPC Server Application on ASP.NET Core

Creating a Basic gRPC Server Application on ASP.NET Core

Learn how to create a basic gRPC application and register its endpoints.

We'll cover the following...

In this lesson, we'll set up a basic gRPC service application, which will act as a server for incoming gRPC requests. We'll use a BasicGrpcService that is based on the ASP.NET Core gRPC service project template. The required files are already set up on the platform for us. However, if we want to duplicate the project setup on our own local development environment, all the necessary instructions are provided in the appendix.

Setting up a gRPC service project

Below, we have a code widget that represents a newly created project based on the gRPC service template:

{
  "profiles": {
    "BasicGrpcService": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": false,
      "applicationUrl": "http://127.0.0.1:5100;https://127.0.0.1:7100",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}
Sample gRPC project based on service template

We can now have a look at the structure of the project we've just created. Let's start with the project file BasicGrpcService.csproj. If we open it, we'll find a reference to the Grpc.AspNetCore NuGet package on line 14. So, if we wanted to retrofit gRPC functionality inside our existing ASP.NET Core project instead of using the gRPC service template, this would be the NuGet package we would have to add.

We also have a reference to a Protobuf file. This is done under the Protobuf element. This element refers to a file with a proto extension that we have inside the folder structure of our project. We can have multiple Protobuf files and multiple Protobuf elements inside the ...