Miscellaneous utility functions to be used when implementing Erlang web server API modules.
This module provides the Erlang web server API module programmer with miscellaneous utility functions.
Note
Note the module is only recommended for using with httpd - for other cases it should be considered as deprecated.
See also
Summary
Functions
convert_request_date/1 converts DateString to
the Erlang date format. DateString must be in one of the three date formats
defined in RFC 2616.
create_etag/1 calculates the Etag for a file from its size and time for last
modification. FileInfo is a record defined in kernel/include/file.hrl.
day/1 converts the day of the week (NthDayOfWeek) from an integer
(1-7) to an abbreviated string, that is
lookup_mime returns the MIME type associated with a specific file suffix as
specified in the file mime.types (located in the config directory).
lookup_mime_default returns the MIME type associated with a specific file
suffix as specified in the mime.types file (located in the config directory).
If no appropriate association is found, the value of DefaultType is returned.
message/3 returns an informative HTTP 1.1 status string in
HTML. Each StatusCode requires a specific PhraseArgs
month/1 converts the month NthMonth as an integer (1-12) to an
abbreviated string, that is
multi_lookup extracts all {Key, Value} tuples from an ETSTable and returns
all Values associated with Key in a list.
reason_phrase returns Description of an HTTP 1.1 StatusCode, for example,
200 is "OK" and 201 is "Created". For more information, see
RFC 2616.
rfc1123_date/0 returns the current date in RFC 1123 format. rfc_date/1
converts the date in the Erlang format to the RFC 1123 date format.
split/3 splits String in N chunks using RegExp. split/3 is equivalent
to re:split/3 with the exception that N defines the maximum number of
fields in FieldList.
split_path/1 splits RequestLine in a file reference
(Path), and a QueryString or a PathInfo string as specified in
RFC 2616. A QueryString is isolated
from Path with a question mark (?) and PathInfo with a slash (/). In the
case of a QueryString, everything before ? is a Path and everything after
? is a QueryString. In the case of a PathInfo, RequestLine is scanned
from left-to-right on the hunt for longest possible Path being a file or a
directory. Everything after the longest possible Path, isolated with a /, is
regarded as PathInfo
split_script_path/1 is equivalent to split_path/1 with one exception. If
the longest possible path is not a regular, accessible, and executable file,
then not_a_script is returned.
Functions
convert_request_date(DateString :: string()) -> ErlDate | bad_date
Types
ErlDate = calendar:datetime()
convert_request_date/1 converts DateString to
the Erlang date format. DateString must be in one of the three date formats
defined in RFC 2616.
create_etag(FileInfo :: file:file_info()) -> Etag
Types
Etag = string()
create_etag/1 calculates the Etag for a file from its size and time for last
modification. FileInfo is a record defined in kernel/include/file.hrl.
Types
DayOfWeek = string()
day/1 converts the day of the week (NthDayOfWeek) from an integer
(1-7) to an abbreviated string, that is:
1 = "Mon", 2 = "Tue", ..., 7 = "Sat".
lookup extracts {Key, Value} tuples from ETSTable and returns the Value
associated with Key. If ETSTable is of type bag, only the first Value
associated with Key is returned. lookup/2 returns undefined
and lookup/3 returns Undefined if no Value is found.
lookup_mime returns the MIME type associated with a specific file suffix as
specified in the file mime.types (located in the config directory).
lookup_mime_default returns the MIME type associated with a specific file
suffix as specified in the mime.types file (located in the config directory).
If no appropriate association is found, the value of DefaultType is returned.
Types
StatusCode = 301 | 304 | 400 | 401 | 403 | 404 | 408 | 412 | 413 | 414 | 500 | 501 | 503 | 504
PhraseArgs = term()
ConfigDB = ets:tid()
Message = string()
message/3 returns an informative HTTP 1.1 status string in
HTML. Each StatusCode requires a specific PhraseArgs:
301-string/0: A URL pointing at the new document position.400 | 401 | 500-none(noPhraseArgs).403 | 404-string/0: ARequest-URIas described in RFC 2616.501-{Method, RequestURI, HTTPVersion}: The HTTPMethod,Request-URI, andHTTP-Versionas defined in RFC 2616.504-string/0: A string describing why the service was unavailable.
Types
Month = string()
month/1 converts the month NthMonth as an integer (1-12) to an
abbreviated string, that is:
1 = "Jan", 2 = "Feb", ..., 12 = "Dec".
multi_lookup extracts all {Key, Value} tuples from an ETSTable and returns
all Values associated with Key in a list.
Types
StatusCode = 100 | 101 | 102 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 226 | 300 | 301 | 302 |
303 | 304 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 |
409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 422 | 423 | 424 | 425 | 426 | 500 |
501 | 502 | 503 | 504 | 505 | 507
Description = string()
reason_phrase returns Description of an HTTP 1.1 StatusCode, for example,
200 is "OK" and 201 is "Created". For more information, see
RFC 2616.
rfc1123_date(LocalTime :: calendar:datetime() | undefined) -> RFC1123Date
Types
RFC1123Date = string() | undefined
rfc1123_date/0 returns the current date in RFC 1123 format. rfc_date/1
converts the date in the Erlang format to the RFC 1123 date format.
Types
String = RegExp = string()
N = non_neg_integer()
SplitRes = {ok, FieldList} | {error, term()}
FieldList = [string()]
split/3 splits String in N chunks using RegExp. split/3 is equivalent
to re:split/3 with the exception that N defines the maximum number of
fields in FieldList.
split_path(URIString :: string()) -> Result
split_path/1 splits RequestLine in a file reference
(Path), and a QueryString or a PathInfo string as specified in
RFC 2616. A QueryString is isolated
from Path with a question mark (?) and PathInfo with a slash (/). In the
case of a QueryString, everything before ? is a Path and everything after
? is a QueryString. In the case of a PathInfo, RequestLine is scanned
from left-to-right on the hunt for longest possible Path being a file or a
directory. Everything after the longest possible Path, isolated with a /, is
regarded as PathInfo
split_script_path(URIString :: string()) -> Split
Types
URIString = Path = PathInfo = QueryString = string()
Split = not_a_script | {Path, {PathInfo, QueryString}} | {Path, []}
split_script_path/1 is equivalent to split_path/1 with one exception. If
the longest possible path is not a regular, accessible, and executable file,
then not_a_script is returned.