grpc/java/README.md

gRPC in 3 minutes (Java)
========================

BACKGROUND
-------------
For this sample, we've already generated the server and client stubs from [helloworld.proto](https://github.com/grpc/grpc-common/blob/master/protos/helloworld.proto). 

PREREQUISITES
-------------

- [Java 8](http://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.html)

- [Maven 3.2 or later](http://maven.apache.org/download.cgi).
  - this is needed to install Netty5, a dependency of gRPC, and to build this sample

INSTALL
-------

1 Clone the gRPC Java git repo
```sh
$ cd <path/to/your/working_dir>
$ git clone https://github.com/grpc/grpc-java
```

2 Install gRPC Java, as described in [How to Build](https://github.com/grpc/grpc-java#how-to-build)
```sh
$ # from this dir
$ cd grpc-java
$ # follow the instructions in 'How to Build'
```

3 Clone this repo, if you've not already done so.
```sh
$ 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
```sh
$ # from this directory
$ mvn package
```

TRY IT!
-------

- Run the server
```sh
$ # from this directory
$ ./run_greeter_server.sh &
```

- Run the client
```sh
$ # from this directory
$ ./run_greeter_client.sh
```