Vert.x gRPC examples

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

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

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.

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

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

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

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

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

This example is adapted from the gRPC examples.

It shows a simple gRPC service that invokes a service that takes 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

This example is the Hello World example with SSL configuration.

It shows a simple gRPC service that invokes a service that takes 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.

This example is adapted from the gRPC examples.

This example shows the various kind of gRPC service calls:

• simple RPC

• server-side streaming RPC

• client-side streaming RPC

• bidirectional streaming RPC

gRPC server example gRPC server stub example gRPC client example gRPC client stub example

You can run the server and then run the client.

You can read more about it on the gRPC website