Latest commit 758915b Jul 11, 2018
Permalink
..
Failed to load latest commit information.
src/main Use counter value as payload body Jun 29, 2017
README.adoc A simple example using SSL. May 22, 2017
build.gradle Update for 3.5.3 Jul 11, 2018
pom.xml Update for 3.5.3 Jul 11, 2018

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:protoc-gen-grpc-java plugin that creates server and stub classes for Vert.x, this plugin is an extension of the io.grpc:protoc-gen-grpc-java plugin.

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.

Ping Pong exchanges

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

Consumer exchange

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

Producer exchange

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

Conversational exchange

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

Hello World 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.

The gRPC service extends the GreeterGrpc.GreeterVertxImplBase generated class and implements the service logic.

The gRPC client creates an instance of the GreeterGrpc.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 takes an HelloRequest string wrapper and returns an HelloReply string wrapper. The communication uses SSL.

The gRPC service extends the GreeterGrpc.GreeterVertxImplBase generated class and implements the service logic.

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

You can run the server and then run the client.

Route Guide example

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

You can run the server and then run the client.

You can read more about it on the gRPC website