NAME

Cache::Swifty - A Perl frontend for the Swifty cache engine

SYNOPSIS

use Cache::Swifty;

my $cache = Cache::Swifty->new({
  dir => 'path_to_cache_dir',
});

$cache->set('key', 'value');
my $value = $cache->get('key');

DESCRIPTION

Cache::Swifty is a perl frontend for the Swifty cache engine. For more information, please refer to http://labs.cybozu.co.jp/blog/kazuhoatwork/swifty/.

THE CONSTRUCTOR

The following parameters are recognized by the new function.

dir

Required. Cache directory to be used. The directory must be initialized prior to calling the method by using the swifty command line tool.

hash_callback

Optional. Reference to a hash function taking a scalar and its length as arguments. If omitted, Cache::Swifty will use its internal adler32 function for hash calculation.

lifetime

Optional. Lifetime of cached entries in seconds. Defaults to 3600 if omitted.

refresh_before

Optional.

flags

Optional.

FLAGS

Cache::Swifty supports following flags. The flags can be set at initialization by using the constructor. It is also possible to adjust the flags laterwards by calling the flags accessor.

FLAGS_USE_CHECKSUM

Flag to activate / disactivate internal checksum for data integrity.

METHODS

get(key)

Returns cached value or undef if not found.

set(key, value[, expires])

Sets given key,value pair. Only scalar variables can be stored.

lifetime([ new_lifetime ])

Accessor for default lifetime.

refresh_before([ new_refresh_before ])

Accessor for the forwarded refresh notifier (set in seconds).

do_refresh()

Returns if the entry should be refreshed.

flags([ new_flags ])

Accessor for flags.

swifty_err()

Returns error code of swifty.

swifty_adler32(scalar)

The default hash function.

SEE ALSO

http://labs.cybozu.co.jp/blog/kazuhoatwork/swify/

AUTHOR

Copyright (c) 2007 Cybozu Labs, Inc. All rights reserved.

written by Kazuho Oku <kazuhooku@gmail.com>

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html