mirror of https://github.com/grpc/grpc-java.git
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). |
||
|---|---|---|
| .. | ||
| android | ||
| gradle/wrapper | ||
| src/main | ||
| thrift | ||
| README.md | ||
| build.gradle | ||
| gradlew | ||
| gradlew.bat | ||
| pom.xml | ||
| settings.gradle | ||
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