grpc-java/examples
Eric Anderson d7bf67e01f examples: Provide Maven and Gradle build files
The examples are no longer part of the normal build, although they are
built with Travis. The examples now include their own copy of the gradle
wrapper to ease usage from IDEs which can now properly detect the
correct version of gradle to use.

The build files were generated using "gradle init" and "mvn
archetype:generate" and then modified following our README.

Fixes #1414
2016-07-11 09:20:25 -07:00
..
android examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
gradle/wrapper examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
src/main examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
README.md examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
build.gradle examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -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 examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -07:00
settings.gradle examples: Provide Maven and Gradle build files 2016-07-11 09:20:25 -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/grpc-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/grpc-examples/bin/hello-world-server

And in a different terminal window run:

$ ./build/install/grpc-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