NAME

       KiokuDB::TypeMap::Entry::Callback - Callback based inflation/deflation of objects

VERSION

       version 0.57

SYNOPSIS

           KiokuDB::TypeMap->new(
               entries => {
                   'My::Class' => KiokuDB::TypeMap::Entry::Callback->new(
                       expand => "new", # My::Class->new(%$self)
                       collapse => sub {
                           my $self = shift;
                           return %$self; # provide args to 'new' in this example
                       },
                       id => sub { "foo" }, # 'id' callback is optional
                   ),
               },
           );

DESCRIPTION

       This KiokuDB::TypeMap entry provides callback based inflation/deflation.

       The major limitation of this method is that it cannot be used for self referential structures. This is
       because the object being inflated is only constructed after all of its arguments are.

       For the overwhelming majority of the use cases this is good enough though.

ATTRIBUTES

       collapse
           A method name or code reference invoked on the object during collapsing.

           This  is  evaluated  in  list  context,  and  the  list of values it returns will be collapsed by the
           KiokuDB::Collapser and then stored.

       expand
           A method name or code reference invoked on the class of the object during loading.

           The arguments are as returned by the "collapse" callback.

       id  An optional method name or code reference invoked to get an ID for the object.

           If one is not provided the default (UUID based) generation is used.

       intrinsic
           A boolean denoting whether or not the object should be collapsed with no ID, and serialized  as  part
           of its parent object.

           This  is  useful  for value like objects, for whom the reference address makes no difference (such as
           URI objects).

AUTHOR

       Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2014 by Yuval Kogman, Infinity Interactive.

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

perl v5.34.0                                       2022-05-23             KiokuDB::TypeMap::Entry::Callback(3pm)