NAME¶
Data::ObjectDriver::Driver::Cache::Apache - object driver for caching objects in
Apache's request space
SYNOPSIS¶
package MyObject;
use base qw( Data::ObjectDriver::BaseObject );
__PACKAGE__->install_properties({
...
driver => Data::ObjectDriver::Driver::Cache::Apache->new(
fallback => 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::Apache provides automatic caching of
retrieved objects in the per-request memory space of your Apache mod_perl
processes, when used in conjunction with your actual object driver. It can be
used to provide even faster results over memcached when requesting objects
that have already been requested during the same request by some other part of
your application, at the cost of the memory necessary to store the objects.
If your models can be used in an Apache mod_perl application as well as another
context such as a command line shell, consider replacing the Apache layer of
your caching with a "Data::ObjectDriver::Driver::Cache::RAM" layer
when Apache is not available. See Data::ObjectDriver::Driver::Cache::Apache.
USAGE¶
- •
- Data::ObjectDriver::Driver::Cache::Apache->new(%params)
Required members of %params are:
- •
- "fallback"
The "Data::ObjectDriver" object driver from which to request
objects that are not found in the Apache process cache.
DIAGNOSTICS¶
The Apache 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 caching operations. The operations
generated by this driver are:
- •
- "APACHECACHE_GET ?"
Retrieve an object. The argument is the cache key for the requested
object.
- •
- "APACHECACHE_ADD ?,?"
Add an object to the cache. The arguments are the cache key for the object
and the flattened representation of the object to cache.
- •
- "APACHECACHE_SET ?,?"
Put an object in the cache. The arguments are the cache key for the object
and the flattened representation of the object to cache.
- •
- "APACHECACHE_DELETE ?"
Remove an object from the cache. The argument is the cache key for the
object to invalidate.
SEE ALSO¶
Apache, Apache2::RequestUtil
LICENSE¶
Data::ObjectDriver is free software; you may redistribute it and/or
modify it under the same terms as Perl itself.
AUTHOR & COPYRIGHT¶
Except where otherwise noted,
Data::ObjectDriver is Copyright 2005-2006
Six Apart, cpan@sixapart.com. All rights reserved.