Maypole::Headers - Convenience wrapper around HTTP::Headers

NAME

Maypole::Headers - Convenience wrapper around HTTP::Headers

SYNOPSIS

    use Maypole::Headers;

    $r->headers_out(Maypole::Headers->new); # Note, automatic in Maypole
    $r->headers_out->set('Content-Base' => 'http://localhost/maypole');
    $r->headers_out->push('Set-Cookie' => $cookie->as_string);
    $r->headers_out->push('Set-Cookie' => $cookie2->as_string);

    print $r->headers_out->as_string;

DESCRIPTION

A convenience wrapper around HTTP::Headers. Additional methods are provided to make the mutators less repetitive and wordy. For example:

    $r->headers_out->header(Content_Base => $r->config->uri_base);

can be written as:

    $r->headers_out->set(Content_Base => $r->config->uri_base);

METHODS

All the standard the HTTP::Headers manpage methods, plus the following:

get($header): Get the value of a header field.; An alias to HTTP::Headers->header
set($header =gt $value, ...): Set the value of one or more header fields; An alias to HTTP::Headers->header
push($header =gt $value): Add a value to the field named $header. Previous values are maintained.; An alias to HTTP::Headers->push_header
add: Alias to push - useful for Apache::Session::Wrapper support, in CGI mode.
init($header =gt $value): Set the value for the field named $header, but only if that header is currently undefined.; An alias to HTTP::Headers->init_header
remove($header, ...): Remove one of more headers; An alias to HTTP::Headers->remove_header
field_names(): Returns a list of distinct header names; An alias to HTTP::Headers->header_field_names

AUTHOR