NAME

       Dancer2::Core::Role::Headers - Role for handling headers

VERSION

       version 0.11

DESCRIPTION

       When a class consumes this role, it gets a "headers" attribute and all the helper methods
       to manipulate it.

       This logic is contained in this role in order to reuse the code between
       Dancer2::Core::Response and Dancer2::Core::Request objects.

ATTRIBUTES

   headers
       The attribute that store the headers in a HTTP::Headers object.

       That attribute coerces from ArrayRef and defaults to an empty HTTP::Headers instance.

METHODS

   header($name)
       Return the value of the given header, if present. If the header has multiple values,
       returns the list of values if called in list context, the first one if in scalar context.

   push_header
       Add the header no matter if it already exists or not.

           $self->push_header( 'X-Wing' => '1' );

       It can also be called with multiple values to add many times the same header with
       different values:

           $self->push_header( 'X-Wing' => 1, 2, 3 );

   headers_to_array
       Convert the "headers" attribute to an ArrayRef.

AUTHOR

       Dancer Core Developers

COPYRIGHT AND LICENSE

       This software is copyright (c) 2013 by Alexis Sukrieh.

       This is free software; you can redistribute it and/or modify it under the same terms as
       the Perl 5 programming language system itself.