NAME

Storable::AMF - Perl extension for serialize/deserialize AMF0/AMF3 data

SYNOPSIS

  use Storable::AMF0 qw(freeze thaw); # or use Storable::AMF3 qw(freeze thaw)l for AMF3 format

  $amf0 = freeze($perl_object);
  $perl_object = thaw($amf0);

        
  # Store/retrieve to disk amf0 data
        
  store $perl_object, 'file';
  $restored_perl_object = retrieve 'file';


  use Storable::AMF0 qw(nstore freeze thaw dclone);

  # Network order: Due to spec of AMF0 format objects (hash, arrayref) stored in network order.
  # and thus nstore and store are synonyms 

  nstore \%table, 'file';
  $hashref = retrieve('file'); 

  
  # Advisory locking
  use Storable::AMF0 qw(lock_store lock_nstore lock_retrieve)
  lock_store \%table, 'file';
  lock_nstore \%table, 'file';
  $hashref = lock_retrieve('file');

DESCRIPTION

This module is (de)serializer for Adobe's AMF0/AMF3 (Action Message Format ver 0-3). This is only module and it recognize only AMF data. Almost all function implemented in C for speed. And some cases faster then Storable( for me always)

EXPORT

  None by default.

FUNCTIONS

freeze($obj) --- Serialize perl object($obj) to AMF, and return AMF data

thaw($amf0) --- Deserialize AMF data to perl object, and return the perl object

store $obj, $file --- Store serialized AMF0 data to file

nstore $obj, $file --- Same as store

retrieve $obj, $file --- Retrieve serialized AMF0 data from file

lock_store $obj, $file --- Same as store but with Advisory locking

lock_nstore $obj, $file --- Same as lock_store

lock_retrieve $file --- Same as retrieve but with advisory locking

dclone $file --- Deep cloning data structure

NOTICE

  Storable::AMF is currently is alpha development stage. 

LIMITATION

At current moment and with restriction of AMF0/AMF3 format referrences to scalar are not serialized, and BigEndian machines are not supported, and can't/ may not serialize tied variables.

TODO

Parse date and XML documents in AMF3 format. Add some options to functions. Add some tests for date/ xml/ xml-doc. Implents destroy object -- to destroy self-refernses objects. Implents objects_leaks -- to test if object referenses self. Add more complex tests.

SEE ALSO

Data::AMF, Storable, Storable::AMF0, Storable::AMF3

AUTHOR

Anatoliy Grishaev, <grian at cpan dot org>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by A. G. Grishaev

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.