Dancer2::Serializer::JSON - Serializer for handling JSON data
Contents
Attributes
content_type
Returns 'application/json'
Copyright And License
This software is copyright (c) 2024 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.
perl v5.40.0 2024-12-08 Dancer2::Serializer::JSON(3pm)
Description
This is a serializer engine that allows you to turn Perl data structures into JSON output and vice-versa.
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.
ConfiguringtheJSONSerializerusing"setengines"
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';
Returningnon-JSONdata.
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.
Methods
serialize($content)
Serializes a Perl data structure into a JSON string.
deserialize($content)
Deserializes a JSON string into a Perl data structure.
Name
Dancer2::Serializer::JSON - Serializer for handling JSON data
Version
version 1.1.2
