NAME
CGI::Application::Plugin::CHI - CGI-App plugin for CHI caching interface
VERSION
Version 0.03
SYNOPSIS
package My::WebApp;
use strict;
use warnings;
use base 'CGI::Application';
use CGI::Application::Plugin::CHI;
__PACKAGE__->cache_config( { driver => 'File', root_dir => '/path/to/nowhere' } );
...
# a runmode
sub a_runmode {
my $self = shift;
$self->cache->set( foo => 42 );
return 'the value of foo is ' . $self->cache->get( 'foo' );
}
EXPORT
This module exports the following methods into your CGI::Application base class: cache_config
, cache_default
, cache
, rmcache
and __get_cache
.
CLASS METHODS
cache_config
This method sets up all your caches and stores their configurations for later retrieval. You can call cache_config
in two ways. The simple way sets up a default cache, and takes a single hashref which is passed directly to CHI:
__PACKAGE__->cache_config( { driver => 'File', root_dir => '/path/to/nowhere' } )
Once it's set up, this default cache can be accessed from anywhere that can call the cache
or rmcache
methods. (e.g. your web application class and any of its subclasses.)
Alternatively, you can pass in a list of name => hashref pairs to set up several caches with different names.
__PACKAGE__->cache_config( ondisk => { driver => 'File', root_dir => '/path/to/nowhere' },
inram => { driver => 'Memory', datastore => \%hash },
distributed => { driver => 'Memcached', ... } );
You can call cache_config
multiple times to add or overwrite additional cache configurations.
These caches can be accessed with the one-argument form of cache
and rmcache
described below.
cache_default
This method designates a named cache as the default cache.
__PACKAGE__->cache_default( 'foobar' ); # $self->cache() now returns the same as $self->cache( 'foobar' )
OBJECT METHODS
cache
This method instantiates and returns a cache which you have previously configured. With no arguments, it returns the default cache, if there is one.
my $cache = $self->cache; # default cache
If there is no default cache, a fatal error occurs.
You can pass the name of a cache as an argument.
my $cache = $self->cache( 'foobar' ); # the foobar cache
If there is no cache with that name, a fatal error occurs.
rmcache
This does the same thing as cache
above, except it performs the extra step of setting the cache's namespace to a concatenation of the current class's name and the current runmode. You can use this to store per-runmode data that you don't want crashing into other runmodes.
sub runmode_foo {
my $self = shift;
my $cache = $self->rmcache( 'foobar' ); # items stored here will be in
# their own namespace
}
Just like cache
, you can call rmcache
with zero arguments to get the default cache with a namespace set.
Note that if you set a namespace when you called cache_config
, using rmcache
will override it.
__get_cache
This method is used internally by cache
and rmcache
to fetch and instantiate the proper cache object. It will be exported to your application, but you should not call it directly.
AUTHOR
Mike Friedman, <friedo at friedo.com>
THANKS
Thanks to 黄叶 for pointing out some documentation bugs, and Jonathan Swartz, Perrin Harkins and the rest of the CHI team.
BUGS
Please report any bugs or feature requests to bug-cgi-application-plugin-chi at rt.cpan.org
, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CGI-Application-Plugin-CHI. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc CGI::Application::Plugin::CHI
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=CGI-Application-Plugin-CHI
AnnoCPAN: Annotated CPAN documentation
CPAN Ratings
Search CPAN
COPYRIGHT & LICENSE
Copyright 2008 Mike Friedman, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.