Jonathan Steinert > Cache-Memcached-Async-0.10_01 > Cache::Memcached::Async

Download:
Cache-Memcached-Async-0.10_01.tar.gz

Dependencies

Annotate this POD

Module Version: 0.10_01   Source  

NAME ^

Cache::Memcached::Async - Asynchronous version of Cache::Memcached

SYNOPSIS ^

  # just like Cache::Memcached
  use Cache::Memcached::Async;
  my $mc = Cache::Memcached::Async->new(servers => [ '127.0.0.1:11211' ]);

DESCRIPTION ^

This is a stripped-down version of Cache::Memcached that performs gets and sets asynchronously, notifying the caller of completion via the Danga::Socket loop.

It's used almost exactly like Cache::Memcached, except that get() and set() are allowed a callback parameter.

Multi-gets are not supported.

METHODS ^

For all the below methods, exptime and timeout are in seconds, and callback will be fired upon response from the server. callback may be undef.

new, add, replace, set, and delete all inherit semantics from Cache::Memcached.

Unlike Cache::Memcached, incr and decr do not return the new value of the key.

Cache::Memcached::Async->new()
$mc->delete($key, timeout => $timeout_seconds, callback => \&callback);
$mc->add($key, $value, exptime => $expiration, timeout => $timeout, callback => \&callback);
$mc->replace($key, $value, exptime => $expiration_seconds, timeout => $timeout_seconds, callback => \&callback);
$mc->set($key, $value, exptime => $expiration_seconds, timeout => $timeout_seconds, callback => \&callback);
$mc->incr($key, $step, timeout => $timeout_seconds, callback => \&callback);
$mc->decr($key, $step, timeout => $timeout_seconds, callback => \&callback);
$mc->get($key, timeout => $timeout_seconds, callback => \&callback);

For get(), callback is passed the cached value on hit, or undef on miss.

SEE ALSO ^

Cache::Memcached

AUTHOR ^

Jonathan Steinert <hachi@cpan.org>

Adam Thomason <athomason@sixapart.com>

COPYRIGHT AND LICENSE ^

Copyright (C) 2010 by Six Apart, Ltd.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: