Alexis Sukrieh > Dancer > Dancer::Serializer

Download:
Dancer-1.3071.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Source   Latest Release: Dancer-1.3125

NAME ^

Dancer::Serializer - serializer wrapper for Dancer

DESCRIPTION ^

This module is the wrapper that provides support for different serializers.

USAGE ^

Default engine

The default serializer used by Dancer::Serializer is Dancer::Serializer::JSON. You can choose another serializer by setting the serializer configuration variable.

Configuration

The serializer configuration variable tells Dancer which serializer to use to deserialize request and serialize response.

You change it either in your config.yml file:

    serializer: "YAML"

Or in the application code:

    # setting JSON as the default serializer
    set serializer => 'JSON';

In your routes you can access parameters just like any route.

When in a route you return a Perl data structure, it will be serialized automatically to the respective serialized engine (for instance, JSON).

For PUT and POST methods you can access the request-body> as a string, and you can unserialize it, if you really need. If your content type is recognized by the serializer, request-body> will be unserialized automatically, and it will be available as a standard parameter.

For instance, if you call

 curl -X POST -H 'Content-Type: application/json -d "{'id':'bar'}" /foo

your foo route can do something like:

  post "/foo" => {
     my $id = param('id'); # gets "bar"
     #  ...
  }

AUTHORS ^

This module has been written by Alexis Sukrieh and Franck Cuny. See the AUTHORS file that comes with this distribution for details.

LICENSE ^

This module is free software and is released under the same terms as Perl itself.

SEE ALSO ^

See Dancer for details about the complete framework.

syntax highlighting: