Provided by: librose-db-object-perl_0.820-2_all bug

NAME

       Rose::DB::Object::Std::Cached - Memory cached standardized object representation of a
       single row in a database table.

SYNOPSIS

         package Category;

         use base 'Rose::DB::Object::Std::Cached';

         __PACKAGE__->meta->setup
         (
           table => 'categories',

           columns =>
           [
             id          => { type => 'int', primary_key => 1 },
             name        => { type => 'varchar', length => 255 },
             description => { type => 'text' },
           ],

           unique_key => 'name',
         );

         ...

         $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"

         ...

DESCRIPTION

       "Rose::DB::Object::Std::Cached" is a subclass of both Rose::DB::Object::Std and
       Rose::DB::Object::Cached.  It simply combines the features of both classes.  See the
       Rose::DB::Object::Std and Rose::DB::Object::Cached documentation for more information.

AUTHOR

       John C. Siracusa (siracusa@gmail.com)

LICENSE

       Copyright (c) 2010 by John C. Siracusa.  All rights reserved.  This program is free
       software; you can redistribute it and/or modify it under the same terms as Perl itself.