README.adoc

Vert.x gRPC examples

Here you will find examples demonstrating Vert.x gRPC in action.

Dependencies required

To use Vert.x gRPC in your own Maven or Gradle project add the following dependency

Group ID: io.vertx
Artifact ID: vertx-grpc

You will need to use the com.google.protobuf plugin to compile the .proto files. These examples use the io.vertx:vertx-grpc-protoc-plugin plugin that creates server and stub classes for Vert.x.

Each example shows how to use the gRPC request/response API and how to use the stub API.

The protobuf compiler is available for Maven or Gradle and is OS dependant.

Empty exchanges

This example show how to handle RPC calls that do not receive or return data.

• gRPC client example

• gRPC client stub example

• gRPC server example

• gRPC server stub example

Ping Pong exchanges

This example show how to handle RPC calls that send a single object and receive a single object.

• gRPC client example

• gRPC client stub example

• gRPC server example

• gRPC server stub example

Consumer exchange

This example show how to handle RPC calls that do receive an arbitrary stream of response objects.

• gRPC client example

• gRPC client stub example

• gRPC server example

• gRPC server stub example

Producer exchange

This example show how to handle RPC calls that do sends an arbitrary stream of request objects.

• gRPC client example

• gRPC client stub example

• gRPC server example

• gRPC server stub example

Conversational exchange

This example shows how to handle arbitrary streams of request and response objects.

• gRPC client example

• gRPC client stub example

• gRPC server example

• gRPC server stub example

Hello World example

This example is adapted from the gRPC examples.

It shows a simple gRPC service that invokes a service that takes an HelloRequest string wrapper and returns an HelloReply string wrapper.

gRPC server example gRPC server stub example

The gRPC service extends the VertxGreeterGrpc.GreeterImplBase generated class and implements the service logic.

gRPC client example gRPC client stub example

The gRPC client creates an instance of the VertxGreeterGrpc.newVertxStub generated class and then use it to invoke the service.

You can run the server and then run the client.

You can read more about it on the gRPC website

SSL example

This example is the Hello World example with SSL configuration.

It shows a simple gRPC service that invokes a service that takes an HelloRequest string wrapper and returns an HelloReply string wrapper. The communication uses SSL.

gRPC server example gRPC server stub example

The gRPC service extends the VertxGreeterGrpc.GreeterImplBase generated class and implements the service logic.

gRPC client example gRPC client stub example

The gRPC client creates an instance of the VertxGreeterGrpc.newVertxStub generated class and then use it to invoke the service.

You can run the server and then run the client.