Add a GET echo example

5 files changed, 105 insertions, 0 deletions

diff --git a/examples/echo_get/src/echo_get.app.src b/examples/echo_get/src/echo_get.app.src
new file mode 100644
index 0000000..ecbf01a
--- /dev/null
+++ b/examples/echo_get/src/echo_get.app.src
@@ -0,0 +1,15 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+{application, echo_get, [
+	{description, "Cowboy GET echo example."},
+	{vsn, "1"},
+	{modules, []},
+	{registered, []},
+	{applications, [
+		kernel,
+		stdlib,
+		cowboy
+	]},
+	{mod, {echo_get_app, []}},
+	{env, []}
+]}.
diff --git a/examples/echo_get/src/echo_get.erl b/examples/echo_get/src/echo_get.erl
new file mode 100644
index 0000000..81d0f43
--- /dev/null
+++ b/examples/echo_get/src/echo_get.erl
@@ -0,0 +1,12 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+-module(echo_get).
+
+%% API.
+-export([start/0]).
+
+%% API.
+
+start() ->
+	ok = application:start(cowboy),
+	ok = application:start(echo_get).
diff --git a/examples/echo_get/src/echo_get_app.erl b/examples/echo_get/src/echo_get_app.erl
new file mode 100644
index 0000000..8220bd3
--- /dev/null
+++ b/examples/echo_get/src/echo_get_app.erl
@@ -0,0 +1,26 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @private
+-module(echo_get_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_get_sup:start_link().
+
+stop(_State) ->
+	ok.
diff --git a/examples/echo_get/src/echo_get_sup.erl b/examples/echo_get/src/echo_get_sup.erl
new file mode 100644
index 0000000..455af04
--- /dev/null
+++ b/examples/echo_get/src/echo_get_sup.erl
@@ -0,0 +1,23 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @private
+-module(echo_get_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_get/src/toppage_handler.erl b/examples/echo_get/src/toppage_handler.erl
new file mode 100644
index 0000000..1322449
--- /dev/null
+++ b/examples/echo_get/src/toppage_handler.erl
@@ -0,0 +1,29 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @doc GET 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),
+	{Echo, Req3} = cowboy_http_req:qs_val(<<"echo">>, Req2),
+	{ok, Req4} = echo(Method, Echo, Req3),
+	{ok, Req4, State}.
+
+echo('GET', undefined, Req) ->
+	cowboy_http_req:reply(400, [], <<"Missing echo parameter.">>, Req);
+echo('GET', Echo, Req) ->
+	cowboy_http_req:reply(200,
+		[{<<"Content-Encoding">>, <<"utf-8">>}], Echo, Req);
+echo(_, _, Req) ->
+	%% Method not allowed.
+	cowboy_http_req:reply(405, Req).
+
+terminate(_Req, _State) ->
+	ok.