grpc-java/examples
Eric Anderson bcf6cc51ca Simplify commands in Android README
Comments should really use '#', since it is shell. Also, we avoid
telling users to clone the git repo since 1) this is basically implicit
already and 2) it encourages them to checkout master instead of using
the latest release. This is especially helpful when the document is
referenced from http://grpc.io/docs since they specify checking out the
latest release (which is much easier to maintain when using jekyll which
is not an option here).
2016-08-17 14:12:41 -07:00
..
android Simplify commands in Android README 2016-08-17 14:12:41 -07:00
gradle/wrapper Update to Gradle 2.14 2016-08-04 10:03:57 -07:00
src/main examples: Explain reason for plainText() 2016-08-04 15:33:36 -07:00
thrift Support Thrift Messages 2016-07-28 08:48:27 -07:00
README.md Fix examples README 2016-07-27 16:50:19 -07:00
build.gradle Update protobuf to 3.0.0 2016-07-29 09:31:15 -07:00
gradlew examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
gradlew.bat examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
pom.xml Update protobuf to 3.0.0 2016-07-29 09:31:15 -07:00
settings.gradle Support Thrift Messages 2016-07-28 08:48:27 -07:00

README.md

grpc Examples

The examples require grpc-java to already be built. You are strongly encouraged to check out a git release tag, since there will already be a build of grpc available. Otherwise you must follow COMPILING.

To build the examples, run in this directory:

$ ./gradlew installDist

This creates the scripts hello-world-server, hello-world-client, route-guide-server, and route-guide-client in the build/install/examples/bin/ directory that run the examples. Each example requires the server to be running before starting the client.

For example, to try the hello world example first run:

$ ./build/install/examples/bin/hello-world-server

And in a different terminal window run:

$ ./build/install/examples/bin/hello-world-client

That's it!

Please refer to gRPC Java's README and tutorial for more information.

Maven

If you prefer to use Maven:

$ mvn verify
$ # Run the server
$ mvn exec:java -Dexec.mainClass=io.grpc.examples.helloworld.HelloWorldServer
$ # In another terminal run the client
$ mvn exec:java -Dexec.mainClass=io.grpc.examples.helloworld.HelloWorldClient