NAME

MooseX::Storage::Format::XML::Simple - An XML::Simple serialization role

VERSION

Version 0.04

SYNOPSIS

        package Point;
        use Moose;
        use MooseX::Storage;

        with Storage('format' => 'XML::Simple');

        has 'x' => (is => 'rw', isa => 'Int');
        has 'y' => (is => 'rw', isa => 'Int');

        1;

        my $p = Point->new(x => 10, y => 10);

        ## methods to freeze/thaw into 
        ## a specified serialization format
        ## (in this case XML)

        # pack the class into a XML string
        $p->freeze(); 

        # <opt>
        #   <__CLASS__>Point</__CLASS__> 
        #   <x>10</x>
        #   <y>10</y>
        # </opt>  

        # unpack the XML string into a class
        my $p2 = Point->thaw(<<XML);  
    <opt>
      <__CLASS__>Point</__CLASS__>
      <x>10</x>
      <y>10</y>
    </opt>
        XML

METHODS

freeze

Serializes the object into the XML string. Uses NoAttr set to 1 while producing XML output.

thaw($xml)

Deserializes the object from the XML string. Uses SuppressEmpty set to undef while producing XML output.

CAVEATS

Some attribute names/hashkeys (eg. starting with digit) will invalidate generated XML output.

BUGS

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

AUTHOR

Bruno Czekay <brunorc@cpan.org>

Based on the code by Yuval Kogman.

COPYRIGHT AND LICENSE

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