NAME
Cache::Memcached::AnyEvent - AnyEvent Compatible Memcached Client
SYNOPSIS
use Cache::Memcached::AnyEvent;
my $memd = Cache::Memcached::AnyEvent->new({
servers => [ '127.0.0.1:11211' ],
compress_threshold => 10_000,
namespace => 'myapp.',
});
$memd->get( $key, sub {
my ($value) = @_;
warn "got $value for $key";
});
$memd->disconnect();
DESRIPTION
WARNING: BETA QUALITY CODE!
This module implements the memcached protocol as a AnyEvent consumer, and it implments both for text and binary protocols.
RATIONALE
There's another alternative AnyEvent memcached client, AnyEvent::Memcached which is perfectly fine, and I have nothing against you using that module. I just have some specific itches to scratch:
- Prerequisites
-
This module, Cache::Memcached::AnyEvent, requires the bare minimum prerequisites to install. AnyEvent::Memcached requires AnyEvent::Connection and Object::Event ;) Those modules are fine, I just don't use them, so I don't want them.
- Binary Protocol
-
I was in the mood to implement the binary protocol. I don't believe it's a requirement to do anything, so this is purely a whim. There's nothing that requires binary protocol in the wild, so it has no practactical advantages. I just wanted to implement it :)
- Cache::Memcached Interface
-
In general, this module follows the interface of Cache::Memcached.
So choose according to your needs. If you for some reason don't want AnyEvent::Connection and Object::Event, want a binary protocol, and like to stick with Cache::Memcached interface (relatively speaking), then use this module. Otherwise, read the docs for each module, and choose the one that fits your needs.
METHODS
All methods interacting with a memcached server which can take a callback function can also take a condvar instead. For example,
$memd->get( "foo", sub {
my $value = shift;
} );
is equivalent to
my $cv = AE::cv {
my $value = $_[0]->recv;
};
$memd->get( "foo", $cv );
# optionally, call $cv->recv here.
new(%args)
- auto_reconnect => $max_attempts
-
Set to 0 to disable auto-reconnecting
- compress_threshold => $number
- hash_cb => $cb->($key, $memcached)
-
Specify hashing coderef. Callback must return an index to the list of the servers, where
$key
belongs to. - namespace => $namespace
- procotol => $object
- protocol_class => $classname
- reconnect_delay => $seconds
-
Amount of time to wait between reconnect attempts
- servers => \@servers
-
List of servers to use.
%args
can also be a hashref.
add($key, $value[, $exptime, $noreply], $cb->($rc))
append($key, $value, $cb->($rc))
connect()
Explicitly connects to each server given. You DO NOT need to call this explicitly.
decr($key, $delta[, $initial], $cb->($value))
delete($key, $cb->($rc))
disconnect()
flush_all()
get($key, $cb->($value))
get_handle( $host_port )
get_multi(\@keys, $cb->(\%values));
incr($key, $delta[, $initial], $cb->($value))
prepend($key, $value, $cb->($rc));
protocol($object)
protocol_class($class)
replace($key, $value[, $exptime, $noreply], $cb->($rc))
remove($key, $cb->($rc))
Alias to delete
servers()
set($key, $value[, $exptime, $noreply], $cb->($rc))
stats($cmd, $cb->(\%stats))
version($cb->(\%result))
TODO
AUTHOR
Daisuke Maki <daisuke@endeworks.jp>
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