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=3203b2d1af9562be086ab54b54127a101c71aca4;hp=cb280dd2b50290d3ece519ba54d65dc3b0d60ad7;hb=b354201608d428db344c63dd35de096a62a7a9d3;hpb=ac5c933bdd463558e8d621507a53a7b247a9093e diff --git a/lib/Catalyst/Response.pm b/lib/Catalyst/Response.pm index cb280dd..3203b2d 100644 --- a/lib/Catalyst/Response.pm +++ b/lib/Catalyst/Response.pm @@ -1,19 +1,27 @@ package Catalyst::Response; use Moose; +use HTTP::Headers; -has cookies => (is => 'rw'); -has body => (is => 'rw'); +with 'MooseX::Emulate::Class::Accessor::Fast'; + +has cookies => (is => 'rw', default => sub { {} }); +has body => (is => 'rw', default => '', lazy => 1, predicate => 'has_body'); has location => (is => 'rw'); -has status => (is => 'rw'); +has status => (is => 'rw', default => 200); +has finalized_headers => (is => 'rw', default => 0); has headers => ( is => 'rw', handles => [qw(content_encoding content_length content_type header)], + default => sub { HTTP::Headers->new() }, + required => 1, + lazy => 1, ); - has _context => ( is => 'rw', weak_ref => 1, + handles => ['write'], + clearer => '_clear_context', ); sub output { shift->body(@_) } @@ -47,15 +55,19 @@ will turn the Catalyst::Response into a HTTP Response and return it to the clien =head1 METHODS -=head2 $res->body(<$text|$fh|$iofh_object) +=head2 $res->body(<$text|$fh|$iohandle_object) $c->response->body('Catalyst rocks!'); Sets or returns the output (text or binary data). If you are returning a large body, -you might want to use a L type of object (Something that implements the read method +you might want to use a L type of object (Something that implements the read method in the same fashion), or a filehandle GLOB. Catalyst will write it piece by piece into the response. +=head2 $res->has_body + +Predicate which returns true when a body has been set. + =head2 $res->content_encoding Shortcut for $res->headers->content_encoding. @@ -114,11 +126,17 @@ Alias for $res->body. =head2 $res->redirect( $url, $status ) -Causes the response to redirect to the specified URL. +Causes the response to redirect to the specified URL. The default status is +C<302>. $c->response->redirect( 'http://slashdot.org' ); $c->response->redirect( 'http://slashdot.org', 307 ); +This is a convenience method that sets the Location header to the +redirect destination, and then sets the response status. You will +want to C< return; > or C< $c->detach() > to interrupt the normal +processing flow if you want the redirect to occur straight away. + =cut sub redirect { @@ -149,19 +167,34 @@ Sets or returns the HTTP status. Writes $data to the output stream. +=head2 meta + +Provided by Moose + +=head2 $res->print( @data ) + +Prints @data to the output stream, separated by $,. This lets you pass +the response object to functions that want to write to an L. + =cut -sub write { shift->_context->write(@_); } +sub print { + my $self = shift; + my $data = shift; -=head2 meta + defined $self->write($data) or return; -Provided by Moose + for (@_) { + defined $self->write($,) or return; + defined $self->write($_) or return; + } + + return 1; +} =head1 AUTHORS -Sebastian Riedel, C - -Marcus Ramberg, C +Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT