NAME

       Jifty::CAS::Store::Memcached - A memcached backend for Jifty's Content-Addressable Storage
       facility

SYNOPSIS

       At the bare minimum, add the following to your Jifty config.yml:

           framework:
             CAS:
               BaseClass: 'Jifty::CAS::Store::Memcached'

       The options available include:

           framework:
             CAS:
               BaseClass: 'Jifty::CAS::Store::Memcached'
               Memcached:
                 # any options Cache::Memcached supports
                 servers:
                   - 10.0.0.2:11211
                   - 10.0.0.3:11211
                 compress_threshold: 5120

               # Turned on by default. Keeps CAS working when memcached fails by
               # falling back to the default in-process store. It probably should
               # be turned off in most cases (like so) after successful testing.
               MemcachedFallback: 0

DESCRIPTION

       This is a memcached backend for Jifty::CAS.  For more information about Jifty's CAS, see
       "DESCRIPTION" in Jifty::CAS.

METHODS

   memcached
       Returns the Cache::Memcached object for this class.

   _store DOMAIN NAME BLOB
       Stores the BLOB (a Jifty::CAS::Blob) in memcached.  Returns the key on success or undef on
       failure.

   key DOMAIN NAME
       Returns the most recent key for the given pair of "DOMAIN" and "NAME", or undef if none
       such exists.

   retrieve DOMAIN KEY
       Returns a Jifty::CAS::Blob for the given pair of "DOMAIN" and "KEY", or undef if none such
       exists.

   memcached_config
       Returns a hashref containing arguments to pass to Cache::Memcached during construction.
       The defaults are like:

         {
             servers     => [ '127.0.0.1:11211' ],
             debug       => 0,
             namespace   => Jifty->config->framework('ApplicationName'),
             compress_threshold => 10240,
         }

       To change these options, set them in your Jifty application config file under
       "/framework/CAS/Memcached" like so:

           framework:
             CAS:
               BaseClass: 'Jifty::CAS::Store::Memcached'
               Memcached:
                   servers:
                       - 10.0.0.2:11211
                       - 10.0.0.3:11211
                   compress_threshold: 5120

   memcached_fallback
       Returns a boolean (from the config file) indicating whether or not memcached should
       fallback to the per-process, in-memory store.