661
clj-xmemcached: memcached client for clojure
Clj-xmemcached is an opensource memcached client for clojure wrapping xmemcached. Xmemcached is an opensource high performance memcached client for java.Leiningen Usage
To include clj-xmemcached,add:
[clj-xmemcached "0.1.1"]
to your project.clj.
Usage
Create a client
(def client (xmemcached "host:port"))
(def client (xmemcached "host1:port1 host2:port2" :protocol "binary"))
Then we create a memcached client using binary protocol to talk with memcached servers host1:port1 and host2:port2. Valid options including:
:name Client's name
:protocol Protocol to talk with memcached,a string value in text,binary or kestrel,default is text protocol.
:hash Hash algorithm,a string value in consistent or standard,default is standard hash.
:timeout Operation timeout in milliseconds,default is five seconds.
:pool Connection pool size,default is one.
Store items
(xset client "key" "dennis" 100)
(xappend client "key" " zhuang")
(xprepend client "key" "hello,")
The value 100 is the expire time for the item in seconds.Store functions include xset,xadd,xreplace,xappend and xprepend.Please use doc to print documentation for these functions.
Get items
(xget client "key1" "key2" "key3")
(xgets client "key")
xgets returns a value including a cas value,for example:
And bulk get returns a HashMap contains existent items.
Increase/Decrease numbers
(xdecr client "num" 1)
(xincr client "num" 1 0)
Above codes try to increase/decrease a number in memcached with key "num",and if the item is not exists,then set it to zero.
Delete items
Compare and set
We use inc function to increase the current value in memcached and try to compare and set it at most Integer.MAX_VALUE times. xcas can be called as:
The cas-fn is a function to return a new value,set the new value to
Shutdown
Flush
(xflush client (InetSocketAddress. host port))
Statistics
Example
Please see the example code in example/demo.clj
License
Copyright (C) 2011-2014 dennis zhuang[killme2008@gmail.com]
Distributed under the Eclipse Public License, the same as Clojure.
文章轉自莊周夢蝶 ，原文發布時間2011-10-30
最後更新：2017-05-18 20:31:44