NAME

Dancer2::Serializer::JSON - Serializer for handling JSON data

VERSION

version 0.207000

DESCRIPTION

This is a serializer engine that allows you to turn Perl data structures into JSON output and vice-versa.

ATTRIBUTES

content_type

Returns 'application/json'

METHODS

serialize($content)

Serializes a Perl data structure into a JSON string.

deserialize($content)

Deserializes a JSON string into a Perl data structure.

FUNCTIONS

from_json($content, \%options)

This is an helper available to transform a JSON data structure to a Perl data structures.

to_json($content, \%options)

This is an helper available to transform a Perl data structure to JSON.

Calling this function will not trigger the serialization's hooks.

Configuring the JSON Serializer using set engines

The JSON serializer options can be configured via set engines. The most common settings are:

allow_nonref

Ignore non-ref scalars returned from handlers. With this set the "Hello, World!" handler returning a string will be dealt with properly.

Set engines should be called prior to setting JSON as the serializer:

 set engines =>
 {
     serializer =>
     {
         JSON =>
         {
            allow_nonref => 1
         },
     }
 };

 set serializer      => 'JSON';
 set content_type    => 'application/json';

Returning non-JSON data.

Handlers can return non-JSON via send_as, which overrides the default serializer:

 get '/' =>
 sub
 {
     send_as html =>
     q{Welcome to the root of all evil...<br>step into my office.}
 };

Any other non-JSON returned format supported by 'send_as' can be used.

AUTHOR

Dancer Core Developers

COPYRIGHT AND LICENSE

This software is copyright (c) 2018 by Alexis Sukrieh.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.