grpc/java/README.md

gRPC in 3 minutes (Java)

PREREQUISITES

• Java 8

• Maven 3.2.

  • this is needed to install Netty5, a dependency of gRPC, and to build this sample

• Latest version of google-protobuf

  • to generate java code from proto files
  • to install the base Java proto3 library

INSTALL

1 Clone the gRPC Java git repo

$ cd <path/to/your/working_dir>
$ git clone https://github.com/grpc/grpc-java

2 Install gRPC Java, as described in How to Build

$ # from this dir
$ cd grpc-java
$ # follow the instructions in 'How to Build'

3 Clone this repo, if you've not already done so.

$ cd <path/to/your/working_dir>
$ git clone https://github.com/grpc/grpc-common
$ cd grpc-common/java  # switch to this directory

4 Build the samples

$ # from this directory
$ mvn package

TRY IT!

• Run the server

$ # from this directory
$ ./run_greeter_server.sh &

• Run the client

$ # from this directory
$ ./run_greeter_client.sh