=pod =begin html

=end html =head1 NAME Cache::Elasticache::Memcache - A wrapper for L with support for AWS's auto reconfiguration mechanism =head1 SYNOPSIS use Cache::Elasticache::Memcache; my $memd = new Cache::Elasticache::Memcache->new({ config_endpoint => 'foo.bar', update_period => 180, # All other options are passed on to Cache::Memcached::Fast ... }); # Will update the server list from the configuration endpoint $memd->updateServers(); # Will update the serverlist from the configuration endpoint if the time since # the last time the server list was checked is greater than the update period # specified when the $memd object was created. $memd->checkServers(); # Class method to retrieve a server list from a configuration endpoint. Cache::Elasticache::Memcache->getServersFromEndpoint('foo.bar'); # All other supported methods are handled by Cache::Memcached::Fast # N.B. This library is currently under development =head1 DESCRIPTION A wrapper for L with support for AWS's auto reconfiguration mechanism. It makes use of an AWS elasticache memcached cluster's configuration endpoint to disctover the memcache servers in the cluster and periodically check the current server list to adapt to a changing cluster. =head1 UNDER DEVELOPMENT DISCALIMER N.B. This module is still under development. It should work, but things may change under the hood. I plan to imporove the resiliance with better timeout handling of communication when updating the server list. Also I'm investigating switching to Dist::Milla. I'm open to suggestions, ideas and pull requests. =cut =pod =head1 CONSTRUCTOR Cache::Elasticache::Memcache->new({ config_endpoint => 'foo.bar', update_period => 180, ... }) =head2 Constructor parameters =over =item config_endpoint AWS elasticache memcached cluster config endpoint location =item update_period The minimum period (in seconds) to wait between updating the server list. Defaults to 180 seconds =back =cut =pod =head1 METHODS =over =item Supported Cache::Memcached::Fast methods These methods can be called on a Cache::Elasticache::Memcache object. The object will call checkServers, then the call will be passed on to the appropriate L code. Please see the L documentation for further details regarding these methods. $memd->enable_compress($enable) $memd->namespace($string) $memd->set($key, $value) $memd->set_multi([$key, $value],[$key, $value, $expiration_time]) $memd->cas($key, $cas, $value) $memd->cas_multi([$key, $cas, $value],[$key, $cas, $value]) $memd->add($key, $value) $memd->add_multi([$key, $value],[$key, $value]) $memd->replace($key, $value) $memd->replace_multi([$key, $value],[$key, $value]) $memd->append($key, $value) $memd->append_multi([$key, $value],[$key, $value]) $memd->prepend($key, $value) $memd->prepend_multi([$key, $value],[$key, $value]) $memd->get($key) $memd->get_multi(@keys) $memd->gets($key) $memd->gets_multi(@keys) $memd->incr($key) $memd->incr_multi(@keys) $memd->decr($key) $memd->decr_multi(@keys) $memd->delete($key) $memd->delete_multi(@keys) $memd->touch($key, $expiration_time) $memd->touch_multi([$key],[$key, $expiration_time]) $memd->flush_all($delay) $memd->nowait_push() $memd->server_versions() $memd->disconnect_all() =cut =pod =item checkServers my $memd = Cache::Elasticache::Memcache->new({ config_endpoint => 'foo.bar' }) ... $memd->checkServers(); Trigger the the server list to be updated if the time passed since the server list was last updated is greater than the update period (default 180 seconds). =cut =pod =item updateServers my $memd = Cache::Elasticache::Memcache->new({ config_endpoint => 'foo.bar' }) ... $memd->updateServers(); This method will update the server list regardles of how much time has passed since the server list was last checked. =cut =pod =back =head1 CLASS METHODS =over =item getServersFromEndpoint Cache::Elasticache::Memcache->getServersFromEndpoint('foo.bar'); This class method will retrieve the server list for a given configuration endpoint. =cut =pod =back =head1 BUGS L =head1 SEE ALSO L - The undelying library used to communicate with memcached servers (apart from autodiscovery) L - AWS's documentation regarding elasticaches's mecached autodiscovery mechanism. =head1 AUTHOR Aaron Moses =head1 WARRANTY There's B, neither explicit nor implied. =head1 COPYWRIGHT Copyright (C) 2015 Aaron Moses. All rights reserved This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =cut