0
Fork 0
mirror of https://github.com/ninenines/cowboy.git synced 2025-07-14 20:30:23 +00:00

Add a REST Hello World example

This commit is contained in:
Loïc Hoguin 2012-07-22 04:46:05 +02:00
parent 6ea32d605d
commit f212cafad2
8 changed files with 141 additions and 0 deletions

View file

@ -0,0 +1,16 @@
Cowboy Hello World
==================
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 run any given command or point your browser to the indicated URL.

View file

@ -0,0 +1,4 @@
{deps, [
{cowboy, ".*",
{git, "git://github.com/extend/cowboy.git", "master"}}
]}.

View file

@ -0,0 +1,15 @@
%% Feel free to use, reuse and abuse the code in this file.
{application, rest_hello_world, [
{description, "Cowboy REST Hello World example."},
{vsn, "1"},
{modules, []},
{registered, []},
{applications, [
kernel,
stdlib,
cowboy
]},
{mod, {rest_hello_world_app, []}},
{env, []}
]}.

View file

@ -0,0 +1,12 @@
%% Feel free to use, reuse and abuse the code in this file.
-module(rest_hello_world).
%% API.
-export([start/0]).
%% API.
start() ->
ok = application:start(cowboy),
ok = application:start(rest_hello_world).

View file

@ -0,0 +1,26 @@
%% Feel free to use, reuse and abuse the code in this file.
%% @private
-module(rest_hello_world_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}]
),
rest_hello_world_sup:start_link().
stop(_State) ->
ok.

View file

@ -0,0 +1,23 @@
%% Feel free to use, reuse and abuse the code in this file.
%% @private
-module(rest_hello_world_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}}.

View file

@ -0,0 +1,39 @@
%% Feel free to use, reuse and abuse the code in this file.
%% @doc Hello world handler.
-module(toppage_handler).
-export([init/3]).
-export([content_types_provided/2]).
-export([hello_to_html/2]).
-export([hello_to_json/2]).
-export([hello_to_text/2]).
init(_Transport, _Req, []) ->
{upgrade, protocol, cowboy_http_rest}.
content_types_provided(Req, State) ->
{[
{<<"text/html">>, hello_to_html},
{<<"application/json">>, hello_to_json},
{<<"text/plain">>, hello_to_text}
], Req, State}.
hello_to_html(Req, State) ->
Body = <<"<html>
<head>
<meta charset=\"utf-8\">
<title>REST Hello World!</title>
</head>
<body>
<p>REST Hello World as HTML!</p>
</body>
</html>">>,
{Body, Req, State}.
hello_to_json(Req, State) ->
Body = <<"{\"rest\": \"Hello World!\"}">>,
{Body, Req, State}.
hello_to_text(Req, State) ->
{<<"REST Hello World as text!">>, Req, State}.

View file

@ -0,0 +1,6 @@
#!/bin/sh
erl -pa ebin deps/*/ebin -s rest_hello_world \
-eval "io:format(\"Get HTML: curl -i http://localhost:8080~n\")." \
-eval "io:format(\"Get JSON: curl -i -H \\\"Accept: application/json\\\" http://localhost:8080~n\")." \
-eval "io:format(\"Get text: curl -i -H \\\"Accept: text/plain\\\" http://localhost:8080~n\")." \
-eval "io:format(\"Get a 406: curl -i -H \\\"Accept: text/css\\\" http://localhost:8080~n\")."