NAME

KiokuDB::Meta::Attribute::Lazy - Trait for lazy loaded attributes

VERSION

version 0.55

SYNOPSIS

# in your class:

package Foo;
use KiokuDB::Class;

has bar => (
    traits => [qw(KiokuDB::Lazy)],
    isa => "Bar",
    is  => "ro",
);



# Later:

my $foo = $dir->lookup($id);

# bar is not yet loaded, it will be lazily fetched during this call:
$foo->bar;

DESCRIPTION

This Moose::Meta::Attribute trait provides lazy loading on a per field basis for objects stored in KiokuDB.

Instead of using proxy objects with AUTOLOAD, overloading, or similar hacks, you can declaratively specify which attributes you want to make lazy, and this will be done cleanly through the MOP.

This is implemented by using a placeholder object, KiokuDB::Thunk which contains references to the ID and the linker, and KiokuDB::Meta::Instance will know to replace the placeholder with the actual loaded object when it is fetched from the object by an accessor.

AUTHOR

Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 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.