X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMooseX%2FStorage%2FBasic.pm;h=66cac0e5e43cab80eb6e19e054e449fad5df0ff6;hb=ec72518379c644ab85126ee0391773ee7028665c;hp=38622fffb3348b13bbc58bd1bcd26a814c9a5493;hpb=1390c23dd40f71e312351625cf8b5d2d9a9eefa4;p=gitmo%2FMooseX-Storage.git

diff --git a/lib/MooseX/Storage/Basic.pm b/lib/MooseX/Storage/Basic.pm
index 38622ff..66cac0e 100644
--- a/lib/MooseX/Storage/Basic.pm
+++ b/lib/MooseX/Storage/Basic.pm
@@ -1,19 +1,54 @@
-
 package MooseX::Storage::Basic;
 use Moose::Role;
 
 use MooseX::Storage::Engine;
 
+our $VERSION   = '0.18';
+our $AUTHORITY = 'cpan:STEVAN';
+
 sub pack {
-    my $self = shift;
-    my $e = MooseX::Storage::Engine->new( object => $self );
-    $e->collapse_object;
+    my ( $self, %args ) = @_;
+    my $e = $self->_storage_get_engine_class(%args)->new( object => $self );
+    $e->collapse_object(%args);
 }
 
 sub unpack {
-    my ( $class, $data ) = @_;
-    my $e = MooseX::Storage::Engine->new( class => $class );
-    $class->new( $e->expand_object($data) );
+    my ($class, $data, %args) = @_;
+    my $e = $class->_storage_get_engine_class(%args)->new(class => $class);
+
+    $class->_storage_construct_instance(
+        $e->expand_object($data, %args),
+        \%args
+    );
+}
+
+sub _storage_get_engine_class {
+    my ($self, %args) = @_;
+
+    my $default = 'MooseX::Storage::Engine';
+
+    return $default
+        unless (
+            exists $args{engine_traits}
+         && ref($args{engine_traits}) eq 'ARRAY'
+         && scalar(@{$args{engine_traits}})
+    );
+
+    my @roles = map { sprintf("%s::Trait::%s", $default, $_) }
+        @{$args{engine_traits}};
+
+    Moose::Meta::Class->create_anon_class(
+        superclasses => [$default],
+        roles => [ @roles ],
+        cache => 1,
+    )->name;
+}
+
+sub _storage_construct_instance {
+    my ($class, $args, $opts) = @_;
+    my %i = defined $opts->{'inject'} ? %{ $opts->{'inject'} } : ();
+
+    $class->new( %$args, %i );
 }
 
 1;
@@ -31,37 +66,52 @@ MooseX::Storage::Basic - The simplest level of serialization
   package Point;
   use Moose;
   use MooseX::Storage;
-  
+
+  our $VERSION = '0.01';
+
   with Storage;
-  
+
   has 'x' => (is => 'rw', isa => 'Int');
   has 'y' => (is => 'rw', isa => 'Int');
-  
+
   1;
-  
+
   my $p = Point->new(x => 10, y => 10);
-  
-  ## methods to pack/unpack an 
+
+  ## methods to pack/unpack an
   ## object in perl data structures
-  
+
   # pack the class into a hash
-  $p->pack(); # { __CLASS__ => 'Point', x => 10, y => 10 }
-  
+  $p->pack(); # { __CLASS__ => 'Point-0.01', x => 10, y => 10 }
+
   # unpack the hash into a class
-  my $p2 = Point->unpack({ __CLASS__ => 'Point', x => 10, y => 10 });
+  my $p2 = Point->unpack({ __CLASS__ => 'Point-0.01', x => 10, y => 10 });
+
+  # unpack the hash, with insertion of paramaters
+  my $p3 = Point->unpack( $p->pack, inject => { x => 11 } );
 
 =head1 DESCRIPTION
 
-This is the most basic form of serialization. This is used by default 
+This is the most basic form of serialization. This is used by default
 but the exported C<Storage> function.
 
 =head1 METHODS
 
 =over 4
 
-=item B<pack>
+=item B<pack ([ disable_cycle_check => 1])>
+
+Providing the C<disable_cycle_check> argument disables checks for any cyclical
+references. The current implementation for this check is rather naive, so if
+you know what you are doing, you can bypass this check.
+
+This trait is applied on a perl-case basis. To set this flag for all objects
+that inherit from this role, see L<MooseX::Storage::Traits::DisableCycleDetection>.
+
+=item B<unpack ($data [, insert => { key => val, ... } ] )>
 
-=item B<unpack ($data)>
+Providing the C<insert> argument let's you supply additional arguments to
+the class' C<new> function, or override ones from the serialized data.
 
 =back
 
@@ -75,7 +125,7 @@ but the exported C<Storage> function.
 
 =head1 BUGS
 
-All complex software has bugs lurking in it, and this module is no 
+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.
 
@@ -87,7 +137,7 @@ Stevan Little E<lt>stevan.little@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2007 by Infinity Interactive, Inc.
+Copyright 2007-2008 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>