NAME
Catalyst::Action::REST - Automated REST Method Dispatching
SYNOPSIS
sub foo :Local :ActionClass('REST') {}
sub foo_GET {
... do something for GET requests ...
}
sub foo_PUT {
... do somethign for PUT requests ...
}
DESCRIPTION
This Action handles doing automatic method dispatching for REST requests. It takes a normal Catalyst action, and changes the dispatch to append an underscore and method name.
For example, in the synopsis above, calling GET on "/foo" would result in the foo_GET method being dispatched.
If a method is requested that is not implemented, this action will return a status 405 (Method Not Found). It will populate the "Allow" header with the list of implemented request methods.
It is likely that you really want to look at Catalyst::Controller::REST.
METHODS
- dispatch
-
This method overrides the default dispatch mechanism to the re-dispatching mechanism described above.
SEE ALSO
You likely want to look at Catalyst::Controller::REST, which implements a sensible set of defaults for a controller doing REST.
Catalyst::Action::Serialize, Catalyst::Action::Deserialize
AUTHOR
Adam Jacob <adam@stalecoffee.org>, with lots of help from mst and jrockway
Marchex, Inc. paid me while I developed this module. (http://www.marchex.com)
LICENSE
You may distribute this code under the same terms as Perl itself.