NAME
Dancer::Headers - Wrapper to handle request headers
SYNOPSYS
use Dancer::Headers;
# $headers may be either an ARRAY of key-value pairs, or
# an HTTP::Headers object.
$dh = Dancer::Headers->new(headers => $headers);
# $dh is now a normalized object, which lets the user do:
# $dh->get('Some-Header');DESCRIPTION
This class implements a wrapper that can provide a common interface to access headers, no matter what their origin is.
When the Dancer application is ran under Plack, the headers are accessed via Plack::Request, which returns a HTTP::Headers object. When under the standalone server (powered by HTTP::Server::Simple::PSGI, the headers are sent as an array.
Dancer::Headers takes care of normalizing those two kind of data structure into a singe object.
METHODS
get($header)
Returns the value of the given $header.
ARRAY references are stored for headers with multiple values. When get is called in a scalar context on such entries, it returns the first value stored, if called in list context, it returns all the values.
$headers = Dancer::Headers->new([foo => 1, foo => 2]);
my $first = $headers->get('foo'); # 1
my @all = $headers->get('foo'); # (1, 2)get_all()
Returns the whole normalized HASH reference.
AUTHORS
This module as been writen by Alexis Sukrieh