-
package MooseX::Storage::Basic;
use Moose::Role;
use MooseX::Storage::Engine;
-our $VERSION = '0.17';
+our $VERSION = '0.26';
our $AUTHORITY = 'cpan:STEVAN';
sub pack {
- my ( $self, @args ) = @_;
- my $e = MooseX::Storage::Engine->new( object => $self );
- $e->collapse_object(@args);
+ my ( $self, %args ) = @_;
+ my $e = $self->_storage_get_engine_class(%args)->new( object => $self );
+ $e->collapse_object(%args);
}
sub unpack {
- my ( $class, $data, @args ) = @_;
- my $e = MooseX::Storage::Engine->new( class => $class );
- $class->new( $e->expand_object($data, @args) );
+ 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 );
}
+no Moose::Role;
+
1;
__END__
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-0.01', x => 10, y => 10 }
-
+
# unpack the hash into a class
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
=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.