Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

moosex::storage::engine(3) [osx man page]

MooseX::Storage::Engine(3)				User Contributed Perl Documentation				MooseX::Storage::Engine(3)

NAME

       MooseX::Storage::Engine - The meta-engine to handle collapsing and expanding objects

DESCRIPTION

       There really aren't any major user serviceable parts here. However the typical use case is adding new non-Moose classes to the type
       registry for serialization. Here is an example of this for DateTime objects. This assumes a "DateTime" type has been registered.

	   MooseX::Storage::Engine->add_custom_type_handler(
	       'DateTime' => (
		   expand   => sub { DateTime->new(shift) },
		   collapse => sub { (shift)->iso8601 },
	       )
	   );

METHODS

   Accessors
       class
       object
       storage
       seen

   API
       expand_object
       collapse_object

   ...
       collapse_attribute
       collapse_attribute_value
       expand_attribute
       expand_attribute_value
       check_for_cycle_in_collapse
       check_for_cycle_in_expansion
       map_attributes

   Type Constraint Handlers
       find_type_handler ($type)
       find_type_handler_for ($name)
       add_custom_type_handler ($name, %handlers)
       remove_custom_type_handler ($name)

   Introspection
       meta

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

       Chris Prather <chris.prather@iinteractive.com>

       Stevan Little <stevan.little@iinteractive.com>

COPYRIGHT AND LICENSE

       Copyright 2007-2008 by Infinity Interactive, Inc.

       <http://www.iinteractive.com>

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

perl v5.16.2							    2012-02-28						MooseX::Storage::Engine(3)

Check Out this Related Man Page

MooseX::Storage::Engine::Trait::OnlyWhenBuilt(3pm)	User Contributed Perl Documentation	MooseX::Storage::Engine::Trait::OnlyWhenBuilt(3pm)

NAME

       MooseX::Storage::Engine::Trait::OnlyWhenBuilt - An engine trait to bypass serialization

SYNOPSIS

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

	       with Storage( traits => [qw|OnlyWhenBuilt|] );

	       has 'x' => (is => 'rw', lazy_build => 1 );
	       has 'y' => (is => 'rw', lazy_build => 1 );
	       has 'z' => (is => 'rw', builder => '_build_z' );

	       sub _build_x { 3 }
	       sub _build_y { expensive_computation() }
	       sub _build_z { 3 }
	   }

	   my $p = Point->new( 'x' => 4 );

	   # the result of ->pack will contain:
	   # { x => 4, z => 3 }
	   $p->pack;

DESCRIPTION

       Sometimes you don't want a particular attribute to be part of the serialization if it has not been built yet. If you invoke "Storage()" as
       outlined in the "Synopsis", only attributes that have been built (ie, where the predicate returns 'true') will be serialized.  This avoids
       any potentially expensive computations.

       This trait is applied to an instance of MooseX::Storage::Engine, for the user-visible version shown in the SYNOPSIS, see
       MooseX::Storage::Traits::OnlyWhenBuilt

METHODS

   Introspection
       meta

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

       Stevan Little <stevan.little@iinteractive.com>

COPYRIGHT AND LICENSE

       Copyright 2007-2008 by Infinity Interactive, Inc.

       <http://www.iinteractive.com>

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

perl v5.14.2							    2009-08-11			MooseX::Storage::Engine::Trait::OnlyWhenBuilt(3pm)
Man Page