mirror of
https://github.com/ninenines/cowboy.git
synced 2025-07-15 04:30:25 +00:00
c747efbd75
This change makes the dependency on quoted optional
by adding a minimal urldecode function to cowboy.
A protocol option for setting the urldecoding function
has been added to the cowboy_http_protocol module.
The default value for this option is set to be
equivalent to the default settings for quoted.
{fun cowboy_http:urldecode/2, crash}
A note has been added in the README to document
how to use quoted instead of this function.
A field to store this option value has been added
to the state record in the cowboy_http_protocol
module and the http_req record in include/http.hrl
Functions that previously used quoted:from_url/1
has been updated to require an equivalent function
in addition to the previously required arguments.
This change removes a C compiler from the build
requirements of cowboy. It also removes the requirement
to cross compile the code if the target arch/OS
is different from the arch/OS used to build it.
75 lines
3.6 KiB
Erlang
75 lines
3.6 KiB
Erlang
%% Copyright (c) 2011, Loïc Hoguin <essen@dev-extend.eu>
|
|
%% Copyright (c) 2011, Anthony Ramine <nox@dev-extend.eu>
|
|
%%
|
|
%% Permission to use, copy, modify, and/or distribute this software for any
|
|
%% purpose with or without fee is hereby granted, provided that the above
|
|
%% copyright notice and this permission notice appear in all copies.
|
|
%%
|
|
%% THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
%% WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
%% MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
%% ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
%% WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
%% ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
%% OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
-type http_method() :: 'OPTIONS' | 'GET' | 'HEAD'
|
|
| 'POST' | 'PUT' | 'DELETE' | 'TRACE' | binary().
|
|
-type http_uri() :: '*' | {absoluteURI, http | https, Host::binary(),
|
|
Port::integer() | undefined, Path::binary()}
|
|
| {scheme, Scheme::binary(), binary()}
|
|
| {abs_path, binary()} | binary().
|
|
-type http_version() :: {Major::non_neg_integer(), Minor::non_neg_integer()}.
|
|
-type http_header() :: 'Cache-Control' | 'Connection' | 'Date' | 'Pragma'
|
|
| 'Transfer-Encoding' | 'Upgrade' | 'Via' | 'Accept' | 'Accept-Charset'
|
|
| 'Accept-Encoding' | 'Accept-Language' | 'Authorization' | 'From' | 'Host'
|
|
| 'If-Modified-Since' | 'If-Match' | 'If-None-Match' | 'If-Range'
|
|
| 'If-Unmodified-Since' | 'Max-Forwards' | 'Proxy-Authorization' | 'Range'
|
|
| 'Referer' | 'User-Agent' | 'Age' | 'Location' | 'Proxy-Authenticate'
|
|
| 'Public' | 'Retry-After' | 'Server' | 'Vary' | 'Warning'
|
|
| 'Www-Authenticate' | 'Allow' | 'Content-Base' | 'Content-Encoding'
|
|
| 'Content-Language' | 'Content-Length' | 'Content-Location'
|
|
| 'Content-Md5' | 'Content-Range' | 'Content-Type' | 'Etag'
|
|
| 'Expires' | 'Last-Modified' | 'Accept-Ranges' | 'Set-Cookie'
|
|
| 'Set-Cookie2' | 'X-Forwarded-For' | 'Cookie' | 'Keep-Alive'
|
|
| 'Proxy-Connection' | binary().
|
|
-type http_headers() :: list({http_header(), iodata()}).
|
|
-type http_cookies() :: list({binary(), binary()}).
|
|
-type http_status() :: non_neg_integer() | binary().
|
|
|
|
-record(http_req, {
|
|
%% Transport.
|
|
socket = undefined :: undefined | inet:socket(),
|
|
transport = undefined :: undefined | module(),
|
|
connection = keepalive :: keepalive | close,
|
|
|
|
%% Request.
|
|
method = 'GET' :: http_method(),
|
|
version = {1, 1} :: http_version(),
|
|
peer = undefined :: undefined | {inet:ip_address(), inet:ip_port()},
|
|
host = undefined :: undefined | cowboy_dispatcher:tokens(),
|
|
host_info = undefined :: undefined | cowboy_dispatcher:tokens(),
|
|
raw_host = undefined :: undefined | binary(),
|
|
port = undefined :: undefined | inet:ip_port(),
|
|
path = undefined :: undefined | '*' | cowboy_dispatcher:tokens(),
|
|
path_info = undefined :: undefined | cowboy_dispatcher:tokens(),
|
|
raw_path = undefined :: undefined | binary(),
|
|
qs_vals = undefined :: undefined | list({binary(), binary() | true}),
|
|
raw_qs = undefined :: undefined | binary(),
|
|
bindings = undefined :: undefined | cowboy_dispatcher:bindings(),
|
|
headers = [] :: http_headers(),
|
|
p_headers = [] :: [any()], %% @todo Improve those specs.
|
|
cookies = undefined :: undefined | http_cookies(),
|
|
|
|
%% Request body.
|
|
body_state = waiting :: waiting | done,
|
|
buffer = <<>> :: binary(),
|
|
|
|
%% Response.
|
|
resp_state = waiting :: locked | waiting | chunks | done,
|
|
resp_headers = [] :: http_headers(),
|
|
resp_body = <<>> :: binary(),
|
|
|
|
%% Functions.
|
|
urldecode :: {fun((binary(), T) -> binary()), T}
|
|
}).
|