X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FResponse.pm;h=a6fbf0f1a750653f0ad113148fe568413cbae061;hp=a84e3c8225c3de855f4923da4b5ef727c5a3396c;hb=bab3a22c7bc0c348a5f336c50eaac376664862a4;hpb=06e1b6164a2c9d7b463f358b0d1934ef83a82845 diff --git a/lib/Catalyst/Response.pm b/lib/Catalyst/Response.pm index a84e3c8..a6fbf0f 100644 --- a/lib/Catalyst/Response.pm +++ b/lib/Catalyst/Response.pm @@ -3,12 +3,14 @@ package Catalyst::Response; use strict; use base 'Class::Accessor::Fast'; -__PACKAGE__->mk_accessors(qw/cookies headers output redirect status/); +__PACKAGE__->mk_accessors(qw/cookies body headers location status/); + +*output = \&body; sub content_encoding { shift->headers->content_encoding(@_) } -sub content_length { shift->headers->content_length(@_) } -sub content_type { shift->headers->content_type(@_) } -sub header { shift->headers->header(@_) } +sub content_length { shift->headers->content_length(@_) } +sub content_type { shift->headers->content_type(@_) } +sub header { shift->headers->header(@_) } =head1 NAME @@ -16,17 +18,18 @@ Catalyst::Response - Catalyst Response Class =head1 SYNOPSIS - $resp = $c->response; - $resp->body; - $resp->content_encoding; - $resp->content_length; - $resp->content_type; - $resp->cookies; - $resp->header; - $resp->headers; - $resp->output; - $resp->redirect; - $resp->status; + $res = $c->response; + $res->body; + $res->content_encoding; + $res->content_length; + $res->content_type; + $res->cookies; + $res->header; + $res->headers; + $res->output; + $res->redirect; + $res->status; + $res->write; See also L. @@ -39,55 +42,103 @@ to response data. =over 4 -=item $resp->body +=item $res->body($text) + + $c->response->body('Catalyst rocks!'); -Shortcut for $resp->output. +Contains the final output. -=item $resp->content_encoding +=item $res->content_encoding -Shortcut to $resp->headers->content_encoding +Shortcut to $res->headers->content_encoding -=item $resp->content_length +=item $res->content_length -Shortcut to $resp->headers->content_length +Shortcut to $res->headers->content_length -=item $resp->content_type +=item $res->content_type -Shortcut to $resp->headers->content_type +Shortcut to $res->headers->content_type -=item $resp->cookies +=item $res->cookies -Returns a reference to a hash containing the cookies to be set. +Returns a reference to a hash containing the cookies to be set. The keys of the +hash are the cookies' names, and their corresponding values are hash references +used to construct L object. $c->response->cookies->{foo} = { value => '123' }; -=item $resp->header +The values correspond to the L parameters of the same name, except +they are used without a leading dash. + +The proxied parameters are + +=over 4 + +=item value + +=item expires + +=item domain + +=item path + +=item secure + +=item + +=back -Shortcut to $resp->headers->header +=item $res->header -=item $resp->headers +Shortcut to $res->headers->header + +=item $res->headers Returns a L object containing the headers. $c->response->headers->header( 'X-Catalyst' => $Catalyst::VERSION ); -=item $resp->output($text) - -Contains the final output. +=item $res->output - $c->response->output('Catalyst rocks!'); +Shortcut to $res->body -=item $resp->redirect($url) +=item $res->redirect( $url, $status ) Contains a location to redirect to. - $c->response->redirect('http://slashdot.org'); + $c->response->redirect( 'http://slashdot.org' ); + $c->response->redirect( 'http://slashdot.org', 307 ); + +=cut + +sub redirect { + my $self = shift; + + if (@_) { + my $location = shift; + my $status = shift || 302; -=item status + $self->location($location); + $self->status($status); + } + + return $self->location; +} + +=item $res->status Contains the HTTP status. $c->response->status(404); + +=item $res->write( $data ) + +Writes $data to the output stream. + +=cut + +sub write { shift->{_context}->write(@_); } =back