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=e0d1a3bc474f5231d17bcdc126e5385f11e41f81;hp=e29380de87ce533e39f82c5a90f7b2f2893dc41a;hb=21465c884872c1ec8c30acd72796445f9eaacb31;hpb=fc7ec1d96ee55d1bf42af3abce155ecb717b9e2b diff --git a/lib/Catalyst/Response.pm b/lib/Catalyst/Response.pm index e29380d..e0d1a3b 100644 --- a/lib/Catalyst/Response.pm +++ b/lib/Catalyst/Response.pm @@ -3,7 +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(@_) } =head1 NAME @@ -11,52 +18,107 @@ Catalyst::Response - Catalyst Response Class =head1 SYNOPSIS -See L. + $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; + +See also L. =head1 DESCRIPTION -The Catalyst Response. +This is the Catalyst Response class, which provides a set of accessors +to response data. + +=head1 METHODS + +=over 4 + +=item $resp->body($text) + + $c->response->body('Catalyst rocks!'); + +Contains the final output. + +=item $resp->content_encoding + +Shortcut to $resp->headers->content_encoding + +=item $resp->content_length -=head2 METHODS +Shortcut to $resp->headers->content_length -=head3 cookies +=item $resp->content_type -Returns a hashref containing the cookies. +Shortcut to $resp->headers->content_type + +=item $resp->cookies + +Returns a reference to a hash containing the cookies to be set. $c->response->cookies->{foo} = { value => '123' }; -=head3 headers +=item $resp->header + +Shortcut to $resp->headers->header + +=item $resp->headers Returns a L object containing the headers. $c->response->headers->header( 'X-Catalyst' => $Catalyst::VERSION ); -=head3 output - -Contains the final output. +=item $resp->output - $c->response->output('Catalyst rockz!'); +Shortcut to $resp->body -=head3 redirect +=item $resp->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 ); -=head3 status +=cut + +sub redirect { + my $self = shift; + + if ( @_ ) { + my $location = shift; + my $status = shift || 302; + + $self->location($location); + $self->status($status); + } + + return $self->location; +} + +=item status Contains the HTTP status. $c->response->status(404); +=back + =head1 AUTHOR Sebastian Riedel, C +Marcus Ramberg, C =head1 COPYRIGHT -This program is free software, you can redistribute it and/or modify it under -the same terms as Perl itself. +This program is free software, you can redistribute it and/or modify +it under the same terms as Perl itself. =cut