Web::Response - common response class for web frameworks
version 0.03
use Web::Request; my $app = sub { my ($env) = @_; my $req = Web::Request->new_from_env($env); # ... return $req->new_response(status => 404)->finalize; };
Web::Response is a response class for PSGI applications. Generally, you will want to create instances of this class via new_response on the request object, since that allows a framework which subclasses Web::Request to also return an appropriate subclass of Web::Response.
new_response
All attributes on Web::Response objects are writable, and the final state of them will be used to generate a real PSGI response when finalize is called.
finalize
Sets (and returns) the status attribute, as described above.
Sets (and returns) the headers attribute, as described above.
Shortcut for $ret->headers->header($name, $val).
$ret->headers->header($name, $val)
Shortcut for $ret->headers->content_length($length).
$ret->headers->content_length($length)
Shortcut for $ret->headers->content_type($type).
$ret->headers->content_type($type)
Shortcut for $ret->headers->content_encoding($encoding).
$ret->headers->content_encoding($encoding)
Shortcut for $ret->headers->header('Location', $location).
$ret->headers->header('Location', $location)
Sets (and returns) the content attribute, as described above.
content
Sets (and returns) the cookies attribute, as described above.
cookies
Sets the Location header to $location, and sets the status code to $status (defaulting to 302 if not given).
Location
Returns a valid PSGI response, based on the values given.
Returns a new Web::Response object. Valid parameters are:
The HTTP status code for the response.
The headers to return with the response. Can be provided as an arrayref, a hashref, or an HTTP::Headers object. Defaults to an HTTP::Headers object with no contents.
The content of the request. Can be provided as a string, an object which overloads "", an arrayref containing a list of either of those, a filehandle, or an object that implements the getline and close methods. Defaults to [].
""
getline
close
[]
A hashref of cookies to return with the response. The values in the hashref can either be the string values of the cookies, or a hashref whose keys can be any of value, domain, path, expires, max-age, secure, httponly. In addition to the date format that expires normally uses, expires can also be provided as a UNIX timestamp (an epoch time, as returned from time). Defaults to {}.
value
domain
path
expires
max-age
secure
httponly
time
{}
Jesse Luehrs <doy at cpan dot org>
This software is copyright (c) 2012 by Jesse Luehrs.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Web::Request, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Web::Request
CPAN shell
perl -MCPAN -e shell install Web::Request
For more information on module installation, please visit the detailed CPAN module installation guide.