grpc-experiments/Step_0.md

Step-0: define a service

This section presents an example of a very simple service definition that receives a message from a remote client. The message contains the users's name and sends back a greeting to that person.

Here it is in full; to be used to generate gRPC code it's defined in it's own file helloworld.proto.

syntax = "proto3";

package helloworld;

// The request message containing the user's name.
message HelloRequest {
  optional string name = 1;
}

// The response message containing the greetings
message HelloReply {
  optional string message = 1;
}

// The greeting service definition.
service Greeting {

  // Sends a greeting
  rpc hello (HelloRequest) returns (HelloReply) {
  }
}

The service stanza of the messages is an example of protobuf service IDL (Interface Defintion Language). Here, it defines a very simple service that receives a request and returns a response.

Next in Step-1, we'll use protoc to generate code this simple definition.