This repo contains a simple demonstration of setting up a message queue, posting to it from a web API and then consuming those messages and processing them from a backend.

The goal is to demonstrate how an HTTP API application could be designed using asynchronous messaging at its core.

You'll need Go installed. Instructions here:

https://golang.org/doc/install

Next, install the gnatsd service and forego and run the server:

./install.sh && cd server && forego start

In a new console:

cd webapp && make && forego start

In a new console:

cd worker && make && forego start

The first example demonstrates the concept of fire-and-forget, where a message is sent and the caller is not concerned with the result:

curl -i http://localhost:8080/cast

You should receive a 200 response from the webapp and you should see a message on the worker console.

The next example demonstrates a request/response, which is synchronous. The caller will block until it receives a response from nats or until a timeout occurs:

curl -i http://localhost:8080/call

You should receive a 200 response from the webapp and the response body should be pong.