Cache::BerkeleyDB(3) User Contributed Perl Documentation Cache::BerkeleyDB(3)
NNAAMMEE
Cache::BerkeleyDB – implements the Cache::Cache interface.
DDEESSCCRRIIPPTTIIOONN
This module implements the Cache interface provided by the Cache::Cache
family of modules written by DeWitt Clinton. It provides a practically
drop-in replacement for Cache::FileCache.
As should be obvious from the name, the backend is based on BerkeleyDB.
SSYYNNOOPPSSIISS
use Cache::BerkeleyDB;
my $cache = new Cache::BerkeleyDB( { 'namespace' => 'MyNamespace',
'default_expires_in' => 600 } );
See Cache::Cache for the usage synopsis.
MMEETTHHOODDSS
See Cache::Cache for the API documentation. Only changes relative to
the standard methods are mentioned below.
CClleeaarr(( [[$$ccaacchhee__rroooott]] ))
See Cache::Cache, with the optional _$_c_a_c_h_e___r_o_o_t parameter.
PPuurrggee(( [[$$ccaacchhee__rroooott]] ))
See Cache::Cache, with the optional _$_c_a_c_h_e___r_o_o_t parameter.
SSiizzee(( [[$$ccaacchhee__rroooott]] ))
See Cache::Cache, with the optional _$_c_a_c_h_e___r_o_o_t parameter.
OOPPTTIIOONNSS
See Cache::Cache for standard options. Additionally, options are set
by passing in a reference to a hash containing any of the following
keys:
_c_a_c_h_e___r_o_o_t
The location in the filesystem that will hold the BDB files repre-
senting the cache namespaces. Defaults to /tmp unless explicitly
set.
_u_m_a_s_k
The umask which will be active when any cache files are created.
Defaults to 002. Note that this will have no effect on existing
files.
PPRROOPPEERRTTIIEESS
See Cache::Cache for default properties.
((ggeett||sseett))__ccaacchhee__rroooott
Acessor pair for the option _c_a_c_h_e___r_o_o_t - see description above.
SSEEEE AALLSSOO
Cache::Cache
Cache::FileCache
BerkeleyDB
Cache::BerkeleyDB_Backend
TTOODDOO
(1) The current version (0.03) uses the framework provided by the
Cache::Cache family of modules quite heavily. In particular, it relies
on Cache::BaseCache and Cache::Object for much of its functionality.
This has obvious advantages; it means, however, that the extra speed
gained by switching from the flat files of Cache::FileCache to a Berke-
leyDB backend is much reduced compared with a top-to-bottom implementa-
tion utilizing the latter’s strengths to the full. Currently the speed
gain relative to Cache::FileCache is in the range of 200% to 350%; I’m
confident this can be increased significantly.
(2) Since each cache namespace is represented as a separate BDB file,
operating with (very) many namespaces in the same process may get you
in trouble. While this has not been verified yet, it may make this ver-
sion unsuitable for some uses, such as in an HTML::Mason environment
under mod_perl. Future versions will probably implement multiple names-
paces in the same file.
(3) The current version is Unix-specific. That will probably change.
AAUUTTHHOORR
Baldur Kristinsson bk@mbl.is, January 2006.
Copyright (c) 2006 Baldur Kristinsson. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
perl v5.8.7 2006-02-02 Cache::BerkeleyDB(3)