content_type

Returns 'application/json'

serialize($content)

Serializes a Perl data structure into a JSON string.

deserialize($content)

Deserializes a JSON string into a Perl data structure.

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.