Plack::Response - Portable HTTP Response object for PSGI response

Author

       Tokuhiro Matsuno

       Tatsuhiko Miyagawa

Description

       Plack::Response allows you a way to create PSGI response array ref through a simple API.

Methods

       new
             $res = Plack::Response->new;
             $res = Plack::Response->new($status);
             $res = Plack::Response->new($status, $headers);
             $res = Plack::Response->new($status, $headers, $body);

           Creates a new Plack::Response object.

       status
             $res->status(200);
             $status = $res->status;

           Sets and gets HTTP status code. "code" is an alias.

       headers
             $headers = $res->headers;
             $res->headers([ 'Content-Type' => 'text/html' ]);
             $res->headers({ 'Content-Type' => 'text/html' });
             $res->headers( HTTP::Headers::Fast->new );

           Sets  and  gets  HTTP  headers  of  the  response. Setter can take either an array ref, a hash ref or
           HTTP::Headers::Fast object containing a list of headers.

       body
             $res->body($body_str);
             $res->body([ "Hello", "World" ]);
             $res->body($io);

           Gets and  sets  HTTP  response  body.  Setter  can  take  either  a  string,  an  array  ref,  or  an
           IO::Handle-like object. "content" is an alias.

           Note  that  this method doesn't automatically set Content-Length for the response. You have to set it
           manually if you want, with the "content_length" method (see below).

       header
             $res->header('X-Foo' => 'bar');
             my $val = $res->header('X-Foo');

           Shortcut for "$res->headers->header".

       content_type, content_length, content_encoding
             $res->content_type('text/plain');
             $res->content_length(123);
             $res->content_encoding('gzip');

           Shortcut for the equivalent get/set methods in "$res->headers".

       redirect
             $res->redirect($url);
             $res->redirect($url, 301);

           Sets redirect URL with an optional status code, which defaults to 302.

           Note that this method doesn't normalize the given URI  string.  Users  of  this  module  have  to  be
           responsible about properly encoding URI paths and parameters.

       location
           Gets and sets "Location" header.

           Note  that  this method doesn't normalize the given URI string in the setter. See above in "redirect"
           for details.

       cookies
             $res->cookies->{foo} = 123;
             $res->cookies->{foo} = { value => '123' };

           Returns a hash reference containing cookies to be set in the response. The keys of the hash  are  the
           cookies'  names,  and their corresponding values are a plain string (for "value" with everything else
           defaults) or a hash reference that can contain keys such as  "value",  "domain",  "expires",  "path",
           "httponly", "secure", "max-age".

           "expires" can take a string or an integer (as an epoch time) and doesnot convert string formats such
           as "+3M".

             $res->cookies->{foo} = {
                 value => 'test',
                 path  => "/",
                 domain => '.example.com',
                 expires => time + 24 * 60 * 60,
             };

       finalize
             $res->finalize;

           Returns the status code, headers, and body of this response as a PSGI response array reference.

       to_app
             $app = $res->to_app;

           A helper shortcut for "sub { $res->finalize }".

Name

       Plack::Response - Portable HTTP Response object for PSGI response

Synopsis

         use Plack::Response;

         sub psgi_handler {
             my $env = shift;

             my $res = Plack::Response->new(200);
             $res->content_type('text/html');
             $res->body("Hello World");

             return $res->finalize;
         }