Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

Catalyst::Action::Deserialize
Deserialize Data in a Request

Catalyst::Action::Deserialize - Deserialize Data in a Request


NAME

Catalyst::Action::Deserialize - Deserialize Data in a Request


SYNOPSIS


    package Foo::Controller::Bar;

    __PACKAGE__->config(

        serialize => {

            'default'   => 'text/x-yaml',

            'stash_key' => 'rest',

            'map'       => {

                'text/x-yaml'        => 'YAML',

                'text/x-data-dumper' => [ 'Data::Serializer', 'Data::Dumper' ],

            },

        }

    );

    sub begin :ActionClass('Deserialize') {}


DESCRIPTION

This action will deserialize HTTP POST, PUT, and OPTIONS requests. It assumes that the body of the HTTP Request is a serialized object. The serializer is selected by introspecting the requests content-type header.

It requires that your Catalyst controller have a ``serialize'' entry in it's configuration. See the Catalyst::Action::Serialize manpage for the details.

The specifics of deserializing each content-type is implemented as a plugin to the Catalyst::Action::Deserialize manpage. You can see a list of currently implemented plugins in the Catalyst::Controller::REST manpage.

The results of your Deserializing will wind up in $c->req->data. This is done through the magic of the Catalyst::Request::REST manpage.

While it is common for this Action to be called globally as a begin method, there is nothing stopping you from using it on a single routine:


   sub foo :Local :Action('Deserialize') {}

Will work just fine.

When you use this module, the request class will be changed to the Catalyst::Request::REST manpage.


SEE ALSO

You likely want to look at the Catalyst::Controller::REST manpage, which implements a sensible set of defaults for a controller doing REST.

the Catalyst::Action::Serialize manpage, the Catalyst::Action::REST manpage


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.

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy