Added support for memcached distributed caching

This commit is contained in:
Len Kranendonk 2005-04-25 05:50:43 +00:00
parent 598ccd1766
commit b417ef09b2
7 changed files with 566 additions and 121 deletions

View file

@ -14,14 +14,9 @@ package WebGUI::Cache;
=cut
use Cache::FileCache;
use HTTP::Headers;
use HTTP::Request;
use LWP::UserAgent;
use WebGUI::ErrorHandler;
use WebGUI::Cache::FileCache;
use WebGUI::Session;
use File::Path;
=head1 NAME
@ -29,7 +24,7 @@ Package WebGUI::Cache
=head1 DESCRIPTION
This package provides a means for WebGUI to cache data to the filesystem.
A base class for all Cache modules to extend.
=head1 SYNOPSIS
@ -42,143 +37,44 @@ These methods are available from this class:
=cut
#-------------------------------------------------------------------
=head2 delete ( )
=head2 flush ( )
Remove content from the filesystem cache.
Flushes the caching system.
=cut
sub delete {
$_[0]->{_cache}->remove($_[0]->{_key});
sub flush {
rmtree($session{config}{uploadsPath}.$session{os}{slash}."temp");
}
#-------------------------------------------------------------------
=head2 deleteByRegex ( regex )
=head2 new ( otions )
Remove content from the filesystem cache where the key meets the condition of the regular expression.
The new method will return a handler for the configured caching mechanism.
Defaults to WebGUI::Cache::FileCache.
=head3 regex
=head3 options
A regular expression that will match keys in the current namespace. Example: m/^navigation_.*/
=cut
sub deleteByRegex {
my @keys = $_[0]->{_cache}->get_keys();
foreach my $key (@keys) {
if ($key =~ $_[1]) {
$_[0]->{_cache}->remove($key);
}
}
}
#-------------------------------------------------------------------
=head2 get ( )
Retrieve content from the filesystem cache.
=cut
sub get {
return $_[0]->{_cache}->get($_[0]->{_key});
}
#-------------------------------------------------------------------
=head2 new ( key [, namespace ] )
Constructor.
=head3 key
A key unique to this namespace. It is used to uniquely identify the cached content.
=head3 namespace
Defaults to the config filename for the current site. The only reason to override the default is if you want the cached content to be shared among all WebGUI instances on this machine. A common alternative namespace is "URL", which is typically used when caching content using the setByHTTP method.
Options to pass to the new constructor. See the caching methods in WebGUI/Cache/*
for documentation of the options.
=cut
sub new {
my $cache;
my $class = shift;
my $key = shift;
my $namespace = shift || $session{config}{configFile};
my %options = (
namespace=>$namespace,
auto_purge_on_set=>1
);
$options{cache_root} = $session{config}{fileCacheRoot} if ($session{config}{fileCacheRoot});
$cache = new Cache::FileCache(\%options);
bless {_cache => $cache, _key => $key}, $class;
}
#-------------------------------------------------------------------
=head2 set ( content [, ttl ] )
Save content to the filesystem cache.
=head3 content
A scalar variable containing the content to be set.
=head3 ttl
The time to live for this content. This is the amount of time (in seconds) that the content will remain in the cache. Defaults to "60".
=cut
sub set {
my $ttl = $_[2] || 60;
$_[0]->{_cache}->set($_[0]->{_key},$_[1],$ttl);
}
#-------------------------------------------------------------------
=head2 setByHTTP ( url [, ttl ] )
Retrieves a document via HTTP and stores it in the cache and returns the content as a string.
=head3 url
The URL of the document to retrieve. It must begin with the standard "http://".
=head3 ttl
The time to live for this content. This is the amount of time (in seconds) that the content will remain in the cache. Defaults to "60".
=cut
sub setByHTTP {
my $userAgent = new LWP::UserAgent;
$userAgent->agent("WebGUI/".$WebGUI::VERSION);
$userAgent->timeout(30);
my $header = new HTTP::Headers;
my $referer = "http://webgui.http.request/".$session{env}{SERVER_NAME}.$session{env}{REQUEST_URI};
chomp $referer;
$header->referer($referer);
my $request = new HTTP::Request (GET => $_[1], $header);
my $response = $userAgent->request($request);
if ($response->is_error) {
WebGUI::ErrorHandler::warn($_[1]." could not be retrieved.");
if($session{config}{memcached_servers}) {
use WebGUI::Cache::Memcached;
return WebGUI::Cache::Memcached->new(@_);
} else {
$_[0]->set($response->content,$_[2]);
return WebGUI::Cache::FileCache->new(@_);
}
return $response->content;
}
1;