NAME

Data::ObjectDriver::Driver::Cache::Memcached - object driver for caching objects with memcached

SYNOPSIS

    package MyObject;
    use base qw( Data::ObjectDriver::BaseObject );

    __PACKAGE__->install_properties({
        ...
        driver => Data::ObjectDriver::Driver::Cache::Memcached->new(
            cache    => Cache::Memcached->new({ servers => \@MEMCACHED_SERVERS }),
            fallback => Data::ObjectDriver::Driver::DBI->new( @$DBI_INFO ),
        ),
        ...
    });

    1;

DESCRIPTION

Data::ObjectDriver::Driver::Cache::Memcached provides automatic caching of retrieved objects in your memcached servers, when used in conjunction with your actual object driver.

USAGE

•: Data::ObjectDriver::Driver::Cache::Memcached->new( %params )
Required members of %params are:

"cache"
The "Cache::Memcached" instance representing your pool of memcached servers. See Cache::Memcached.
"fallback"
The "Data::ObjectDriver" object driver from which to request objects that are not found in your memcached servers.

DIAGNOSTICS

The memcached driver provides integration with the "Data::ObjectDriver" debug and profiling systems. As these systems are designed around SQL queries, synthetic queries are logged to represent memcached operations. The operations generated by this driver are:

"MEMCACHED_ADD ?"
Put an item in the cache that was not there. The arguments are the cache key for the object and the flattened representation of the object to cache.
"MEMCACHED_SET ?"
Put an item in the cache with new member data. The arguments are the cache key for the object and the flattened representation of the object to cache.
"MEMCACHED_DELETE ?"
Remove an object from the cache. The argument is the cache key for the object to invalidate.
"MEMCACHED_GET ?"
Retrieve an object. The argument is the cache key for the requested object.
"MEMCACHED_GET_MULTI ?"
Retrieve a set of objects. The arguments are the cache keys for the requested objects.

LICENSE

Data::ObjectDriver is free software; you may redistribute it and/or modify it under the same terms as Perl itself.