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 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() 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 Binary stats is not yet implemented. Other hashing mechanisms. Consistent Hashing (patches welcome) AUTHOR Daisuke Maki "" 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