X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FRequest.pm;h=f6ffd4ef5e5688804607d8d2a56e0e68f0ee46a1;hb=1927c219b552ac80dff59c235a51d422ac5b9d25;hp=f06e27e256851e9f06d2c4120a7c40738eb507fb;hpb=0556eb49954590b794221ed3a033565c85dbeb32;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Request.pm b/lib/Catalyst/Request.pm index f06e27e..f6ffd4e 100644 --- a/lib/Catalyst/Request.pm +++ b/lib/Catalyst/Request.pm @@ -11,93 +11,153 @@ __PACKAGE__->mk_accessors( *args = \&arguments; *params = \¶meters; +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 referer { shift->headers->referer(@_) } +sub user_agent { shift->headers->user_agent(@_) } + =head1 NAME Catalyst::Request - Catalyst Request Class =head1 SYNOPSIS -See L. + + $req = $c->request; + $req->action; + $req->address; + $req->args; + $req->arguments; + $req->base; + $req->content_encoding; + $req->content_length; + $req->content_type; + $req->cookies; + $req->header; + $req->headers; + $req->hostname; + $req->match; + $req->method; + $req->parameters; + $req->params; + $req->path; + $req->referer; + $req->snippets; + $req->uploads; + $req->user_agent + +See also L. =head1 DESCRIPTION -The Catalyst Request. +This is the Catalyst Request class, which provides a set of accessors to the +request data. The request object is prepared by the specialized Catalyst +Engine module thus hiding the details of the particular engine implementation. + -=head2 METHODS +=head1 METHODS -=head3 action +=over 4 + +=item $req->action Contains the action. print $c->request->action; -=head3 address +=item $req->address Contains the remote address. print $c->request->address -=head3 arguments (args) +=item $req->arguments + +=item $req->args -Returns an arrayref containing the arguments. +Returns a reference to an array containing the arguments. print $c->request->arguments->[0]; -=head3 base +=item $req->base Contains the uri base. -=head3 cookies +=item $req->content_encoding + +Shortcut to $req->headers->content_encoding -Returns a hashref containing the cookies. +=item $req->content_length + +Shortcut to $req->headers->content_length + +=item $req->content_type + +Shortcut to $req->headers->content_type + +=item $req->cookies + +Returns a reference to a hash containing the cookies. print $c->request->cookies->{mycookie}->value; -=head3 headers +=item $req->header + +Shortcut to $req->headers->header -Returns a L object containing the headers. +=item $req->headers + +Returns an L object containing the headers. print $c->request->headers->header('X-Catalyst'); -=head3 hostname +=item $req->hostname Contains the remote hostname. print $c->request->hostname -=head3 match +=item $req->match Contains the match. print $c->request->match; -=head3 parameters (params) +=item $req->method + +Contains the request method (C, C, C, etc). + + print $c->request->method + +=item $req->parameters + +=item $req->params -Returns a hashref containing the parameters. +Returns a reference to a hash containing the parameters. print $c->request->parameters->{foo}; -=head3 path +=item $req->path Contains the path. print $c->request->path; -=head3 method +=item $req->referer -Contains the request method. +Shortcut to $req->headers->referer - print $c->request->method - -=head3 snippets +=item $req->snippets -Returns an arrayref containing regex snippets. +Returns a reference to an array containing regex snippets. my @snippets = @{ $c->request->snippets }; -=head3 uploads +=item $req->uploads -Returns a hashref containing the uploads. +Returns a reference to a hash containing the uploads. my $filename = $c->req->parameters->{foo}; print $c->request->uploads->{$filename}->{type}; @@ -105,6 +165,12 @@ Returns a hashref containing the uploads. my $fh = $c->request->uploads->{$filename}->{fh}; my $content = do { local $/; <$fh> }; +=item $req->user_agent + +Shortcut to $req->headers->user_agent + +=back + =head1 AUTHOR Sebastian Riedel, C