Koichi Taniguchi > Cache-Memcached-Indexable-0.03 > Cache::Memcached::Indexable

Download:
Cache-Memcached-Indexable-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.03   Source  

NAME ^

Cache::Memcached::Indexable - A key indexable Cache::Memcached wrapper

SYNOPSIS ^

 use Cache::Memcached::Indexable;
 
 $memd = new Cache::Memcached::Indexable {
     'servers' => [ "10.0.0.15:11211", "10.0.0.15:11212",
                    "10.0.0.17:11211", [ "10.0.0.17:11211", 3 ] ],
     'debug' => 0,
     'compress_threshold' => 10_000,
 };
 $memd->set_servers($array_ref);
 $memd->set_compress_threshold(10_000);
 $memd->enable_compress(0);
 
 $memd->set("my_key", "Some value");
 $memd->set("object_key", { 'complex' => [ "object", 2, 4 ]});
 
 $val = $memd->get("my_key");
 $val = $memd->get("object_key");
 if ($val) { print $val->{'complex'}->[2]; }
 
 $memd->incr("key");
 $memd->decr("key");
 $memd->incr("key", 2);
 
 @all_keys = $memd->keys;

DESCRIPTION ^

THIS IS ALPHA SOFTWARE

Cache::Memcached::Indexable is a key indexable memcached interface. It is a simple wrapper class of Cache::Memcached. Usually, we can't get any key information of stored data with using memcached. This module provides keys() method (likes CORE::keys()) for getting all of stored key information.

In fact, this module uses only a few patterns of knowable key, and it stores the key with the value of large hash-ref. It controls the large hash-ref when you call set, get or delete methods.

It was implantated some functions of Cache::Memcached. But the implanted functions are only documented functions. Note that some undocumented functions weren't implanted to this module.

CONSTRUCTOR ^

new

Takes one parameter, a hashref of options. Almost same as Cache::Memcached's constructor. But it has some additional parameter.

  • logic

    The parameter of logic is the name of your chosen logic class or the entity of the logic class instance.

     $memd = Cache::Memcached::Indexable->new({
         logic      => 'Cache::Memcached::Indexable::Logic::DigestSHA1',
         logic_args => { set_max_power => 0xFF },
         %memcached_args,
     })

    and the following code is same as above:

     use Cache::Memcached::Indexable::Logic::DigestSHA1;
    
     $logic = Cache::Memcached::Indexable::Logic::DigestSHA1->new({
         set_max_power => 0xFF,
     });
     
     $memd = Cache::Memcached::Indexable->new({
         logic => $logic,
         %memcached_args,
     });
  • logic_args

    The arguments of your specified logic class (see above.)

  • memd

    You may specify your favorite memcached interface class. But it must have Cache::Memcached compatibility (e.g. Cache::Memcached::XS).

METHODS ^

keys()

You can get all of stored keys with calling this method.

And the usage of following methods. See Cache::Memcached document.

set_servers
set_debug
set_readonly
set_norehash
set_compress_threshold
enable_compress
get
get_multi
set
add
replace
delete
incr
decr
stats
disconnect_all
flush_all

WARRANTY ^

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

AUTHOR ^

Koichi Taniguchi <taniguchi@livedoor.jp>

LICENSE ^

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO ^

Cache::Memcached, Cache::Memcached::Indexable::Logic, Cache::Memcached::Indexable::Logic::Default

syntax highlighting: