# NAME Cache::KyotoTycoon::REST - Client library for KyotoTycoon RESTful API # SYNOPSIS use Cache::KyotoTycoon::REST; my $kt = Cache::KyotoTycoon::REST->new(host => $host, port => $port); $kt->put("foo", "bar", 100); # store key "foo" and value "bar". $kt->get("foo"); # => "bar" $kt->delete("foo"); # remove key # DESCRIPTION Cache::KyotoTycoon::REST is client library for KyotoTycoon RESTful API. # CONSTRUCTOR - port - host - timeout - db Database name or number. # METHODS - my $val = $kt->get($key); Retrieve the value for a _$key_. _$key_ should be a scalar. _Return:_ value associated with the _$key_ and _$expires_ time in RFC1123 date format of GMT, empty string on no expiration time, or undef on $key is not found. - my $expires = $kt->head($key); Check the _$key_ is exists or not. _Return:_ _$expires_: RFC 1123 date format of GMT, empty string on no expiration time, or undef if $key not found. - $kt->put($key, $val[, $expires]); Store the _$val_ on the server under the _$key_. _$key_ should be a scalar. _$value_ should be defined and may be of any Perl data type. _$expires_: expiration time. If $expires>0, expiration time in seconds from now. If $expires<0, the epoch time. It is never remove if missing $expires. _Return:_ 1 if server returns OK(201), or _undef_ in case of some error. - $kt->delete($key); Remove cache data for $key. _Return:_ 1 if server returns OK(200). 0 if server returns not found(404), or _undef_ in case of some error. # AUTHOR Tokuhiro Matsuno # SEE ALSO [Cache::KyotoTycoon](http://search.cpan.org/perldoc?Cache::KyotoTycoon) # LICENSE Copyright (C) Tokuhiro Matsuno This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.