aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2012-07-21 22:19:13 +0200
committerLoïc Hoguin <[email protected]>2012-07-22 05:09:56 +0200
commit73c07376bb1371afd3a10c4dc135912cfe16a247 (patch)
treebcd4a9ec4e6582f71df33741a7ba2fa298768941
parent370b3d96485daa2bac0ed4aebecb867dca5f8d3e (diff)
downloadcowboy-73c07376bb1371afd3a10c4dc135912cfe16a247.tar.gz
cowboy-73c07376bb1371afd3a10c4dc135912cfe16a247.tar.bz2
cowboy-73c07376bb1371afd3a10c4dc135912cfe16a247.zip
Add a POST echo example
-rw-r--r--examples/echo_post/README.md24
-rwxr-xr-xexamples/echo_post/curl_post.sh2
-rw-r--r--examples/echo_post/rebar.config4
-rw-r--r--examples/echo_post/src/echo_post.app.src15
-rw-r--r--examples/echo_post/src/echo_post.erl12
-rw-r--r--examples/echo_post/src/echo_post_app.erl26
-rw-r--r--examples/echo_post/src/echo_post_sup.erl23
-rw-r--r--examples/echo_post/src/toppage_handler.erl36
-rwxr-xr-xexamples/echo_post/start.sh3
9 files changed, 145 insertions, 0 deletions
diff --git a/examples/echo_post/README.md b/examples/echo_post/README.md
new file mode 100644
index 0000000..dcfa913
--- /dev/null
+++ b/examples/echo_post/README.md
@@ -0,0 +1,24 @@
+Cowboy POST Echo
+================
+
+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
+```
+
+Then point your browser to the indicated URL. You can change
+the GET parameter to check that the handler is echoing properly.
+
+Then run the following command, replacing STRING_TO_ECHO by the
+string you want to echo. Check the ```curl_post.sh``` file for details.
+
+```
+./curl_post.sh STRING_TO_ECHO
+```
diff --git a/examples/echo_post/curl_post.sh b/examples/echo_post/curl_post.sh
new file mode 100755
index 0000000..c9ec987
--- /dev/null
+++ b/examples/echo_post/curl_post.sh
@@ -0,0 +1,2 @@
+#!/bin/sh
+curl -i -d echo=$1 http://localhost:8080
diff --git a/examples/echo_post/rebar.config b/examples/echo_post/rebar.config
new file mode 100644
index 0000000..6ad3062
--- /dev/null
+++ b/examples/echo_post/rebar.config
@@ -0,0 +1,4 @@
+{deps, [
+ {cowboy, ".*",
+ {git, "git://github.com/extend/cowboy.git", "master"}}
+]}.
diff --git a/examples/echo_post/src/echo_post.app.src b/examples/echo_post/src/echo_post.app.src
new file mode 100644
index 0000000..74ff7f3
--- /dev/null
+++ b/examples/echo_post/src/echo_post.app.src
@@ -0,0 +1,15 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+{application, echo_post, [
+ {description, "Cowboy POST echo example."},
+ {vsn, "1"},
+ {modules, []},
+ {registered, []},
+ {applications, [
+ kernel,
+ stdlib,
+ cowboy
+ ]},
+ {mod, {echo_post_app, []}},
+ {env, []}
+]}.
diff --git a/examples/echo_post/src/echo_post.erl b/examples/echo_post/src/echo_post.erl
new file mode 100644
index 0000000..0073a80
--- /dev/null
+++ b/examples/echo_post/src/echo_post.erl
@@ -0,0 +1,12 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+-module(echo_post).
+
+%% API.
+-export([start/0]).
+
+%% API.
+
+start() ->
+ ok = application:start(cowboy),
+ ok = application:start(echo_post).
diff --git a/examples/echo_post/src/echo_post_app.erl b/examples/echo_post/src/echo_post_app.erl
new file mode 100644
index 0000000..bb74d4a
--- /dev/null
+++ b/examples/echo_post/src/echo_post_app.erl
@@ -0,0 +1,26 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @private
+-module(echo_post_app).
+-behaviour(application).
+
+%% API.
+-export([start/2]).
+-export([stop/1]).
+
+%% API.
+
+start(_Type, _Args) ->
+ Dispatch = [
+ {'_', [
+ {[], toppage_handler, []}
+ ]}
+ ],
+ {ok, _} = cowboy:start_listener(http, 100,
+ cowboy_tcp_transport, [{port, 8080}],
+ cowboy_http_protocol, [{dispatch, Dispatch}]
+ ),
+ echo_post_sup:start_link().
+
+stop(_State) ->
+ ok.
diff --git a/examples/echo_post/src/echo_post_sup.erl b/examples/echo_post/src/echo_post_sup.erl
new file mode 100644
index 0000000..6f973c0
--- /dev/null
+++ b/examples/echo_post/src/echo_post_sup.erl
@@ -0,0 +1,23 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @private
+-module(echo_post_sup).
+-behaviour(supervisor).
+
+%% API.
+-export([start_link/0]).
+
+%% supervisor.
+-export([init/1]).
+
+%% API.
+
+-spec start_link() -> {ok, pid()}.
+start_link() ->
+ supervisor:start_link({local, ?MODULE}, ?MODULE, []).
+
+%% supervisor.
+
+init([]) ->
+ Procs = [],
+ {ok, {{one_for_one, 10, 10}, Procs}}.
diff --git a/examples/echo_post/src/toppage_handler.erl b/examples/echo_post/src/toppage_handler.erl
new file mode 100644
index 0000000..aed26e6
--- /dev/null
+++ b/examples/echo_post/src/toppage_handler.erl
@@ -0,0 +1,36 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @doc POST echo handler.
+-module(toppage_handler).
+
+-export([init/3]).
+-export([handle/2]).
+-export([terminate/2]).
+
+init(_Transport, Req, []) ->
+ {ok, Req, undefined}.
+
+handle(Req, State) ->
+ {Method, Req2} = cowboy_http_req:method(Req),
+ {HasBody, Req3} = cowboy_http_req:has_body(Req2),
+ {ok, Req4} = maybe_echo(Method, HasBody, Req3),
+ {ok, Req4, State}.
+
+maybe_echo('POST', true, Req) ->
+ {PostVals, Req2} = cowboy_http_req:body_qs(Req),
+ Echo = proplists:get_value(<<"echo">>, PostVals),
+ echo(Echo, Req2);
+maybe_echo('POST', false, Req) ->
+ cowboy_http_req:reply(400, [], <<"Missing body.">>, Req);
+maybe_echo(_, _, Req) ->
+ %% Method not allowed.
+ cowboy_http_req:reply(405, Req).
+
+echo(undefined, Req) ->
+ cowboy_http_req:reply(400, [], <<"Missing echo parameter.">>, Req);
+echo(Echo, Req) ->
+ cowboy_http_req:reply(200,
+ [{<<"Content-Encoding">>, <<"utf-8">>}], Echo, Req).
+
+terminate(_Req, _State) ->
+ ok.
diff --git a/examples/echo_post/start.sh b/examples/echo_post/start.sh
new file mode 100755
index 0000000..4359abe
--- /dev/null
+++ b/examples/echo_post/start.sh
@@ -0,0 +1,3 @@
+#!/bin/sh
+erl -pa ebin deps/*/ebin -s echo_post \
+ -eval "io:format(\"Run ./curl_post.sh STRING_TO_ECHO\")."