NAME

App::Serializer::Properties - Interface for serialization and deserialization

SYNOPSIS

use App;

$context = App->context();
$serializer = $context->service("Serializer");  # or ...
$serializer = $context->serializer();
$data = {
    an => 'arbitrary',
    collection => [ 'of', 'data', ],
    of => {
        arbitrary => 'depth',
    },
};
$propdata = $serializer->serialize($data);
$data = $serializer->deserialize($propdata);
print $serializer->dump($data), "\n";

DESCRIPTION

A Serializer allows you to serialize a structure of data of arbitrary depth to a scalar and deserialize it back to the structure.

The Properties serializer reads and writes data which conforms to the standards of Java properties files.

Class: App::Serializer::Properties

* Throws: App::Exception::Serializer
* Since:  0.01

Design

The class is entirely made up of static (class) methods. However, they are each intended to be called as methods on the instance itself.

Constructor Methods:

new()

The constructor is inherited from App::Service.

Public Methods:

serialize()

* Signature: $propdata = $serializer->serialize($data);
* Param:     $data              ref
* Return:    $propdata           text
* Throws:    App::Exception::Serializer
* Since:     0.01

Sample Usage: 

$context = App->context();
$serializer = $context->service("Serializer");  # or ...
$serializer = $context->serializer();
$data = {
    an => 'arbitrary',
    collection => [ 'of', 'data', ],
    of => {
        arbitrary => 'depth',
    },
};
$propdata = $serializer->serialize($data);

deserialize()

* Signature: $data = $serializer->deserialize($propdata);
* Signature: $data = App::Serializer->deserialize($propdata);
* Param:     $data              ref
* Return:    $propdata           text
* Throws:    App::Exception::Serializer
* Since:     0.01

Sample Usage: 

$context = App->context();
$serializer = $context->service("Serializer");  # or ...
$serializer = $context->serializer();
$data = $serializer->deserialize($propdata);
print $serializer->dump($data), "\n";

dump()

The constructor is inherited from App::Serializer.

ACKNOWLEDGEMENTS

* Author:  Stephen Adkins <spadkins@gmail.com>
* License: This is free software. It is licensed under the same terms as Perl itself.

SEE ALSO

App::Context, App::Service