deepstream-rpc-example

An example of using Deepstream for microservices RPC.

The example starts two microservices and registers them with the Deepstream server. The provided client app sends requests to each of the services.

Prerequisites

This example requires a running instance of the Deepstream server.

You can pull the latest Deepstream server from DockerHub using the following command:

$ docker pull deepstreamio/deepstream.io

Create a container from this image using the following command:

$ docker create -t -p 6020:6020 -p 8080:8080 \
   --name deepstream.io \
   -v $(pwd)/conf:/usr/local/deepstream/conf \
   -v $(pwd)/var:/usr/local/deepstream/var \
   deepstreamio/deepstream.io

Start the Deepstream server using the following command:

$ docker start -ia deepstream.io

Running the Example

You can run the example using the following commands:

1. In a new terminal window start the Foo Service using the following command:

    $ ./gradlew :foo-service:run
   

2. In a new terminal window start the Bar Service using the following command:

    $ ./gradlew :bar-service:run
   

3. In a new terminal window start the Client using the following command:

    $ ./gradlew :client:run
   

   If successful, you will see the following in the client terminal:

    > Task :client:run
    [main] INFO demo.deepstream.client.Main - Sending request to 'services.foo'...
    [main] INFO demo.deepstream.client.Main - Response from 'services.foo': Hello, World! - from 'services.foo'
    [main] INFO demo.deepstream.client.Main - Sending request to 'services.bar'...
    [main] INFO demo.deepstream.client.Main - Response from 'services.bar': Hello, World! - from 'services.bar'
   

Bugs and Feedback

For bugs, questions, and discussions please use the Github Issues.

License

Copyright 2018 Greg Whitaker

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.