From f9dd3c9e54da7690db6f936d644c1c7b88ac6e9b Mon Sep 17 00:00:00 2001 From: Adam Cammack Date: Sun, 10 Feb 2013 13:54:51 -0600 Subject: Add a REST example that streams its response --- examples/rest_stream_response/README.md | 66 +++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 examples/rest_stream_response/README.md (limited to 'examples/rest_stream_response/README.md') diff --git a/examples/rest_stream_response/README.md b/examples/rest_stream_response/README.md new file mode 100644 index 0000000..70e1ba7 --- /dev/null +++ b/examples/rest_stream_response/README.md @@ -0,0 +1,66 @@ +Cowboy REST Streaming Responses +=============================== + +To compile this example you need rebar in your PATH. + +Type the following command: +``` +$ rebar get-deps compile +``` + +You can then start the Erlang node with the following command: +``` +./start.sh +``` + +This example simulates streaming a large amount of data from a data store one +record at a time in CSV format. It also uses a constraint to ensure that the +last segment of the route is an integer. + +Examples +-------- + +### Get records with a field 2 value of 1 + +``` bash +$ curl -i localhost:8080 +HTTP/1.1 200 OK +transfer-encoding: identity +server: Cowboy +date: Sun, 10 Feb 2013 19:32:16 GMT +connection: close +content-type: text/csv + +DBUZGQ0C,1,28 +BgoQAxMV,1,6 +DAYEFxER,1,18 +... +``` + +### Get records with a field 2 value of 4 + +``` bash +$ curl -i localhost:8080/4 +HTTP/1.1 200 OK +transfer-encoding: identity +server: Cowboy +date: Sun, 10 Feb 2013 19:34:31 GMT +connection: close +content-type: text/csv + +ABcFDxcE,4,42 +DgYQCgEE,4,5 +CA8BBhYD,4,10 +... +``` + +### Get a 404 + +``` bash +$ curl -i localhost:8080/foo +HTTP/1.1 404 Not Found +connection: keep-alive +server: Cowboy +date: Sun, 10 Feb 2013 19:36:16 GMT +content-length: 0 +``` -- cgit v1.2.3