++ed by:
KEEDI RBUELS LLAP PERLER WREIS

8 PAUSE users
5 non-PAUSE users.

Author image Tomas Doran
and 1 contributors

NAME

Catalyst::Request::REST - A REST-y subclass of Catalyst::Request

SYNOPSIS

     if ( $c->request->accepts('application/json') ) {
         ...
     }

     my $types = $c->request->accepted_content_types();

DESCRIPTION

This is a subclass of Catalyst::Request that adds a few methods to the request object to faciliate writing REST-y code. Currently, these methods are all related to the content types accepted by the client.

Note that if you have a custom request class in your application, and it does not inherit from Catalyst::Request::REST, your application will fail with an error indicating a conflict the first time it tries to use Catalyst::Request::REST's functionality. To fix this error, make sure your custom request class inherits from Catalyst::Request::REST.

METHODS

data

If the request went through the Deserializer action, this method will return the deserialized data structure.

accepted_content_types

Returns an array reference of content types accepted by the client.

The list of types is created by looking at the following sources:

  • Content-type header

    If this exists, this will always be the first type in the list.

  • content-type parameter

    If the request is a GET request and there is a "content-type" parameter in the query string, this will come before any types in the Accept header.

  • Accept header

    This will be parsed and the types found will be ordered by the relative quality specified for each type.

If a type appears in more than one of these places, it is ordered based on where it is first found.

preferred_content_type

This returns the first content type found. It is shorthand for:

  $request->accepted_content_types->[0]
accepts($type)

Given a content type, this returns true if the type is accepted.

Note that this does not do any wildcard expansion of types.

AUTHORS

See Catalyst::Action::REST for authors.

LICENSE

You may distribute this code under the same terms as Perl itself.