Steve Purkis > Pixie > Pixie::Proxy

Download:
Pixie-2.08_02.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Module Version: 2.08_02   Source  

NAME ^

Pixie::Proxy - placeholders for real objects in a Pixie store

SYNOPSIS ^

  use Pixie::Proxy;

  # this only works for blessed Hashes & Arrays currently:
  my $obj   = MyObject->new
  my $proxy = Pixie::Proxy->px_make_proxy( $obj );

  # a while later, after the obj has been stored and $obj goes away...
  $obj = undef;

  $proxy->a_method;  # same as $obj->a_method, with a lot of magic

  # auto-magically loads $obj from the store, copies it into
  # $proxy, and re-blesses $proxy into the right class (MyObject)
  # before calling a_method() on it.

DESCRIPTION ^

Pixie::Proxy lets you load objects from a Pixie store on demand. So if you have a tree of objects and you only need to access the root node of the tree, you don't have to face the performance hit of loading the entire tree.

Pixie::Proxy and its subclasses magically fetch the object from the store whenever a method is called, (and if your class uses overload, whenever an overloaded operator is used).

If proxying interferes with your code, or if you simply prefer to load an entire object heirarchy at one go, simply set the px_is_immediate constant to some true value in the classes you don't want proxied.

AUTHORS ^

Piers Cawley <pdcawley@bofh.org.uk> - code

Steve Purkis <spurkis@cpan.org> - docs

SEE ALSO ^

Pixie, Pixie::Complicity

syntax highlighting: