Rose::DB::Object::Cached

Memory cached object representation of a single row in a database table.
Download

Rose::DB::Object::Cached Ranking & Summary

Advertisement

  • Rating:
  • License:
  • Perl Artistic License
  • Price:
  • FREE
  • Publisher Name:
  • John C. Siracusa
  • Publisher web site:
  • http://search.cpan.org/~jsiracusa/

Rose::DB::Object::Cached Tags


Rose::DB::Object::Cached Description

Memory cached object representation of a single row in a database table. Rose::DB::Object::Cached is a Perl module with a memory cached object representation of a single row in a database table.SYNOPSIS package Category; use Rose::DB::Object::Cached; our @ISA = qw(Rose::DB::Object::Cached); __PACKAGE__->meta->table('categories'); __PACKAGE__->meta->columns ( id => { type => 'int', primary_key => 1 }, name => { type => 'varchar', length => 255 }, description => { type => 'text' }, ); __PACKAGE__->meta->add_unique_key('name'); __PACKAGE__->meta->initialize; ... $cat1 = Category->new(id => 123, name => 'Art'); $cat1->save or die $category->error; $cat2 = Category->new(id => 123); # This will load from the memory cache, not the database $cat2->load or die $cat2->error; # $cat2 is the same object as $cat1 print "Yep, cached" if($cat1 eq $cat2); # No, really, it's the same object $cat1->name('Blah'); print $cat2->name; # prints "Blah" # The object cache supports time-based expiration Category->cached_objects_expire_in('15 minutes'); $cat1 = Category->new(id => 123); $cat1->save or $cat1->die; $cat1->load; # loaded from cache $cat2 = Category->new(id => 123); $cat2->load; # loaded from cache $cat3 = Category->new(id => 123); $cat3->load; # NOT loaded from cache ...Rose::DB::Object::Cached is a subclass of Rose::DB::Object that is backed by a write-through memory cache. Whenever an object is loaded from or saved to the database, it is cached in memory. Any subsequent attempt to load an object of the same class with the same primary key or unique key value(s) will give you the cached object instead of loading from the database.This means that modifications to an object will also modify all other objects in memory that have the same primary key. The synopsis above highlights this fact.This class is most useful for encapsulating "read-only" rows, or other data that is updated very infrequently. In the Category example above, it would be inefficient to repeatedly load category information in a long-running process (such as a mod_perl Apache web server) if that information changes infrequently.The memory cache can be cleared for an individual object or all objects of the same class. There is also support for simple time-based cache expiration. See the clear_object_cache and cached_objects_expire_in methods for more information.Only the methods that are overridden or otherwise behaviorally modified are documented here. See the Rose::DB::Object documentation for the rest. Requirements: · Perl


Rose::DB::Object::Cached Related Software