binnian / vertx-grpc

gRPC for Vert.x

Vert.x gRPC

Currently for Vert.x 3.4.0-SNAPSHOT

• Documentation
• Vert.x gRPC Java Compiler

Supports:

• client and server
• server scaling
• ssl configuration with options
• auto close in Verticle

Todo:

• contribute support to grpc-java Netty implementation to provide async start/shutdown
• worker integration ?

Plugin installation

To use vertx-grpc-protoc-plugin with the protobuf-maven-plugin, add a custom protoc plugin configuration section.

<protocPlugins>
    <protocPlugin>
        <id>vertx-grpc-protoc-plugin</id>
        <groupId>io.vertx</groupId>
        <artifactId>vertx-grpc-protoc-plugin</artifactId>
        <version>[VERSION]</version>
        <mainClass>io.vertx.grpc.protoc.plugin.VertxGrpcGenerator</mainClass>
    </protocPlugin>
</protocPlugins>

And add the vertx-grpc dependency:

<dependency>
  <groupId>io.vertx</groupId>
  <artifactId>vertx-grpc</artifactId>
  <version>[VERSION]</version>
</dependency>