XMemcachedClient (xmemcached 2.4.7 API)

java.lang.Object
- net.rubyeye.xmemcached.XMemcachedClient

All Implemented Interfaces:

MemcachedClient, XMemcachedClientMBean

Direct Known Subclasses:

AWSElasticCacheClient
```
public class XMemcachedClient
extends Object
implements XMemcachedClientMBean, MemcachedClient
```
Memcached Client for connecting to memcached server and do operations.

Author:

dennis(killme2008@gmail.com)

Field Summary

Fields
Modifier and Type	Field and Description
`protected CommandFactory`	`commandFactory`
`protected int`	`connectionPoolSize`
`protected MemcachedConnector`	`connector`
`protected int`	`maxQueuedNoReplyOperations`
`static ThreadLocal<String>`	`NAMESPACE_LOCAL` namespace thread local.
`protected long`	`opTimeout`
`protected boolean`	`resolveInetAddresses`
`protected AtomicInteger`	`serverOrderCount`
`protected MemcachedSessionComparator`	`sessionComparator`
`protected MemcachedSessionLocator`	`sessionLocator`

Fields inherited from interface net.rubyeye.xmemcached.MemcachedClient
DEFAULT_CONNECT_TIMEOUT, DEFAULT_CONNECTION_POOL_SIZE, DEFAULT_HEAL_SESSION_INTERVAL, DEFAULT_MAX_QUEUED_NOPS, DEFAULT_MAX_TIMEOUTEXCEPTION_THRESHOLD, DEFAULT_OP_TIMEOUT, DEFAULT_READ_THREAD_COUNT, DEFAULT_SESSION_IDLE_TIMEOUT, DEFAULT_SESSION_READ_BUFF_SIZE, DEFAULT_TCP_KEEPLIVE, DEFAULT_TCP_NO_DELAY, DEFAULT_TCP_RECV_BUFF_SIZE, DEFAULT_TCP_SEND_BUFF_SIZE, DYNAMIC_MAX_QUEUED_NOPS, MAX_QUEUED_NOPS

Constructor Summary

Constructors
Constructor and Description
`XMemcachedClient()`
`XMemcachedClient(InetSocketAddress inetSocketAddress)`
`XMemcachedClient(InetSocketAddress inetSocketAddress, int weight)`
`XMemcachedClient(InetSocketAddress inetSocketAddress, int weight, CommandFactory cmdFactory)` XMemcached Constructor.
`XMemcachedClient(List<InetSocketAddress> addressList)` XMemcached Constructor.Every server's weight is one by default.
`XMemcachedClient(List<InetSocketAddress> addressList, CommandFactory cmdFactory)` XMemcached Constructor.Every server's weight is one by default.
`XMemcachedClient(MemcachedSessionLocator locator, MemcachedSessionComparator comparator, BufferAllocator allocator, Configuration conf, Map<SocketOption,Object> socketOptions, CommandFactory commandFactory, Transcoder transcoder, Map<InetSocketAddress,InetSocketAddress> addressMap, List<MemcachedClientStateListener> stateListeners, Map<InetSocketAddress,AuthInfo> map, int poolSize, long connectTimeout, String name, boolean failureMode, boolean resolveInetAddresses)` XMemcachedClient constructor.Every server's weight is one by default.
`XMemcachedClient(String server, int port)` XMemcached constructor,default weight is 1
`XMemcachedClient(String host, int port, int weight)` XMemcached constructor

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`add(String key, int exp, Object value)`
`boolean`	`add(String key, int exp, Object value, long timeout)`
`<T> boolean`	`add(String key, int exp, T value, Transcoder<T> transcoder)`
`<T> boolean`	`add(String key, int exp, T value, Transcoder<T> transcoder, long timeout)` Add key-value item to memcached, success only when the key is not exists in memcached.
`void`	`addOneServerWithWeight(String server, int weight)` Add a memcached server
`void`	`addServer(InetSocketAddress inetSocketAddress)` Add a memcached server,the thread call this method will be blocked until the connecting operations completed(success or fail)
`void`	`addServer(InetSocketAddress inetSocketAddress, int weight)`
`void`	`addServer(String hostList)` Add memcached servers
`void`	`addServer(String server, int port)` Aadd a memcached server,the thread call this method will be blocked until the connecting operations completed(success or fail)
`void`	`addServer(String server, int port, int weight)` add a memcached server to MemcachedClient
`void`	`addStateListener(MemcachedClientStateListener listener)` Add a memcached client listener
`void`	`addWithNoReply(String key, int exp, Object value)` Add key-value item to memcached, success only when the key is not exists in memcached.This method doesn't wait for reply.
`<T> void`	`addWithNoReply(String key, int exp, T value, Transcoder<T> transcoder)`
`boolean`	`append(String key, Object value)`
`boolean`	`append(String key, Object value, long timeout)` Append value to key's data item,this method will wait for reply
`void`	`appendWithNoReply(String key, Object value)` Append value to key's data item,this method doesn't wait for reply.
`void`	`beginWithNamespace(String ns)` set current namespace for following operations with memcached client.It must be ended with `MemcachedClient.endWithNamespace()` method.For example:
`<T> boolean`	`cas(String key, CASOperation<T> operation)`
`<T> boolean`	`cas(String key, GetsResponse<T> getsReponse, CASOperation<T> operation)`
`<T> boolean`	`cas(String key, int exp, CASOperation<T> operation)`
`<T> boolean`	`cas(String key, int exp, CASOperation<T> operation, Transcoder<T> transcoder)` Cas is a check and set operation which means "store this data but only if no one else has updated since I last fetched it."
`<T> boolean`	`cas(String key, int exp, GetsResponse<T> getsReponse, CASOperation<T> operation)`
`<T> boolean`	`cas(String key, int exp, GetsResponse<T> getsReponse, CASOperation<T> operation, Transcoder<T> transcoder)` cas is a check and set operation which means "store this data but only if no one else has updated since I last fetched it."
`boolean`	`cas(String key, int exp, Object value, long cas)`
`boolean`	`cas(String key, int exp, Object value, long timeout, long cas)`
`<T> boolean`	`cas(String key, int exp, T value, Transcoder<T> transcoder, long cas)`
`<T> boolean`	`cas(String key, int exp, T value, Transcoder<T> transcoder, long timeout, long cas)` Cas is a check and set operation which means "store this data but only if no one else has updated since I last fetched it."
`<T> void`	`casWithNoReply(String key, CASOperation<T> operation)`
`<T> void`	`casWithNoReply(String key, GetsResponse<T> getsResponse, CASOperation<T> operation)`
`<T> void`	`casWithNoReply(String key, int exp, CASOperation<T> operation)`
`<T> void`	`casWithNoReply(String key, int exp, GetsResponse<T> getsReponse, CASOperation<T> operation)` cas noreply
`protected void`	`checkException(Command command)`
`protected void`	`connect(InetSocketAddressWrapper inetSocketAddressWrapper)`
`long`	`decr(String key, long delta)` "decr" are used to change data for some item in-place, decrementing it.
`long`	`decr(String key, long delta, long initValue)`
`long`	`decr(String key, long delta, long initValue, long timeout)` "decr" are used to change data for some item in-place, decrementing it.
`long`	`decr(String key, long delta, long initValue, long timeout, int exp)` "incr" are used to change data for some item in-place, incrementing it.
`void`	`decrWithNoReply(String key, long delta)` "decr" are used to change data for some item in-place, decrementing it.
`boolean`	`delete(String key)`
`boolean`	`delete(String key, int time)` Delete key's data item from memcached.It it is not exists,return false. time is the amount of time in seconds (or Unix time until which) the client wishes the server to refuse "add" and "replace" commands with this key.
`boolean`	`delete(String key, long opTimeout)` Delete key's date item from memcached
`boolean`	`delete(String key, long cas, long opTimeout)` Delete key's date item from memcached only if its cas value is the same as what was read.
`void`	`deleteWithNoReply(String key)`
`void`	`deleteWithNoReply(String key, int time)` Delete key's data item from memcached.This method doesn't wait for reply
`void`	`endWithNamespace()` Remove current namespace set for this memcached client.It must begin with `MemcachedClient.beginWithNamespace(String)` method.
`void`	`flushAll()` Make All connected memcached's data item invalid
`void`	`flushAll(InetSocketAddress address)` Invalidate all existing items immediately
`void`	`flushAll(InetSocketAddress address, long timeout)`
`void`	`flushAll(InetSocketAddress address, long timeout, int exptime)`
`void`	`flushAll(int exptime, long timeout)`
`void`	`flushAll(long timeout)` Make All connected memcached's data item invalid
`void`	`flushAll(String host)` This method is deprecated,please use flushAll(InetSocketAddress) instead.
`void`	`flushAllWithNoReply()`
`void`	`flushAllWithNoReply(InetSocketAddress address)`
`void`	`flushAllWithNoReply(InetSocketAddress address, int exptime)`
`void`	`flushAllWithNoReply(int exptime)`
`<T> Map<String,T>`	`get(Collection<String> keyCollections)`
`<T> Map<String,T>`	`get(Collection<String> keyCollections, long timeout)`
`<T> Map<String,T>`	`get(Collection<String> keyCollections, long timeout, Transcoder<T> transcoder)` Bulk get items
`<T> Map<String,T>`	`get(Collection<String> keyCollections, Transcoder<T> transcoder)`
`<T> T`	`get(String key)`
`<T> T`	`get(String key, long timeout)`
`<T> T`	`get(String key, long timeout, Transcoder<T> transcoder)` Get value by key
`<T> T`	`get(String key, Transcoder<T> transcoder)`
`<T> T`	`getAndTouch(String key, int newExp)` Get item and set a new expiration time for it,using default opTimeout
`<T> T`	`getAndTouch(String key, int newExp, long opTimeout)` Get item and set a new expiration time for it
`Map<InetSocketAddress,AuthInfo>`	`getAuthInfoMap()` return current all auth info
`Map<String,AuthInfo>`	`getAuthInfoStringMap()` Retruns the AuthInfo for all server strings (hostname:port)
`Collection<InetSocketAddress>`	`getAvailableServers()` Returns available memcached servers list.
`Collection<InetSocketAddress>`	`getAvaliableServers()` Deprecated.
`CommandFactory`	`getCommandFactory()`
`int`	`getConnectionSizeBySocketAddress(InetSocketAddress address)`
`Connector`	`getConnector()` return the session manager
`long`	`getConnectTimeout()` Get the connect timeout
`Counter`	`getCounter(String key)` Get counter for key,and if the key's value is not set,then set it with 0.
`Counter`	`getCounter(String key, long initialValue)` Get counter for key,and if the key's value is not set,then set it with initial value.
`long`	`getHealSessionInterval()` Return the default heal session interval in milliseconds
`KeyIterator`	`getKeyIterator(InetSocketAddress address)` Deprecated. memcached 1.6.x will remove cachedump stats command,so this method will be removed in the future
`KeyProvider`	`getKeyProvider()`
`String`	`getName()` Return the cache instance name
`String`	`getNamespace(String ns)` Returns the real namespace of ns.
`long`	`getOpTimeout()` get operation timeout setting
`Protocol`	`getProtocol()`
`Queue<ReconnectRequest>`	`getReconnectRequestQueue()` Returns reconnecting task queue,the queue is thread-safe and 'weakly consistent',but maybe you should not modify it at all.
`<T> Map<String,GetsResponse<T>>`	`gets(Collection<String> keyCollections)`
`<T> Map<String,GetsResponse<T>>`	`gets(Collection<String> keyCollections, long timeout)`
`<T> Map<String,GetsResponse<T>>`	`gets(Collection<String> keyCollections, long timeout, Transcoder<T> transcoder)` Bulk gets items
`<T> Map<String,GetsResponse<T>>`	`gets(Collection<String> keyCollections, Transcoder<T> transcoder)`
`<T> GetsResponse<T>`	`gets(String key)`
`<T> GetsResponse<T>`	`gets(String key, long timeout)`
`<T> GetsResponse<T>`	`gets(String key, long timeout, Transcoder<T> transcoder)` Just like get,But it return a GetsResponse,include cas value for cas update.
`<T> GetsResponse<T>`	`gets(String key, Transcoder transcoder)`
`List<String>`	`getServersDescription()` Get all connected memcached servers
`MemcachedSessionComparator`	`getSessionComparator()`
`MemcachedSessionLocator`	`getSessionLocator()`
`Collection<MemcachedClientStateListener>`	`getStateListeners()` Get all current state listeners
`Map<InetSocketAddress,Map<String,String>>`	`getStats()`
`Map<InetSocketAddress,Map<String,String>>`	`getStats(long timeout)` Get stats from all memcached servers
`Map<InetSocketAddress,Map<String,String>>`	`getStatsByItem(String itemName)` Get special item stats.
`Map<InetSocketAddress,Map<String,String>>`	`getStatsByItem(String itemName, long timeout)`
`int`	`getTimeoutExceptionThreshold()` Returns maximum number of timeout exception for closing connection.
`Transcoder`	`getTranscoder()` return default transcoder,default is SerializingTranscoder
`Map<InetSocketAddress,String>`	`getVersions()` Get all connected memcached servers's version.
`Map<InetSocketAddress,String>`	`getVersions(long timeout)`
`long`	`incr(String key, long delta)` "incr" are used to change data for some item in-place, incrementing it.
`long`	`incr(String key, long delta, long initValue)`
`long`	`incr(String key, long delta, long initValue, long timeout)` "incr" are used to change data for some item in-place, incrementing it.
`long`	`incr(String key, long delta, long initValue, long timeout, int exp)` "incr" are used to change data for some item in-place, incrementing it.
`void`	`incrWithNoReply(String key, long delta)` "incr" are used to change data for some item in-place, incrementing it.
`void`	`invalidateNamespace(String ns)` Invalidate all namespace under the namespace using the default operation timeout.
`void`	`invalidateNamespace(String ns, long opTimeout)` Invalidate all items under the namespace.
`boolean`	`isFailureMode()` Returns if client is in failure mode.
`boolean`	`isSanitizeKeys()`
`boolean`	`isShutdown()`
`protected void`	`latchWait(Command cmd, long timeout, Session session)`
`protected MemcachedConnector`	`newConnector(BufferAllocator bufferAllocator, Configuration configuration, MemcachedSessionLocator memcachedSessionLocator, MemcachedSessionComparator memcachedSessionComparator, CommandFactory commandFactory, int poolSize, int maxQueuedNoReplyOperations)`
`protected InetSocketAddress`	`newSocketAddress(String server, int port)`
`boolean`	`prepend(String key, Object value)`
`boolean`	`prepend(String key, Object value, long timeout)` Prepend value to key's data item in memcached.This method doesn't wait for reply.
`void`	`prependWithNoReply(String key, Object value)` Prepend value to key's data item in memcached.This method doesn't wait for reply.
`void`	`removeServer(InetSocketAddress address)` Remove memcached server with the exact given address.
`void`	`removeServer(String hostList)` Remove memcached servers
`void`	`removeStateListener(MemcachedClientStateListener listener)` Remove a memcached client listener
`boolean`	`replace(String key, int exp, Object value)`
`boolean`	`replace(String key, int exp, Object value, long timeout)`
`<T> boolean`	`replace(String key, int exp, T value, Transcoder<T> transcoder)`
`<T> boolean`	`replace(String key, int exp, T value, Transcoder<T> transcoder, long timeout)` Replace the key's data item in memcached,success only when the key's data item is exists in memcached.This method will wait for reply from server.
`void`	`replaceWithNoReply(String key, int exp, Object value)` Replace the key's data item in memcached,success only when the key's data item is exists in memcached.This method doesn't wait for reply from server.
`<T> void`	`replaceWithNoReply(String key, int exp, T value, Transcoder<T> transcoder)`
`protected Session`	`sendCommand(Command cmd)`
`boolean`	`set(String key, int exp, Object value)`
`boolean`	`set(String key, int exp, Object value, long timeout)`
`<T> boolean`	`set(String key, int exp, T value, Transcoder<T> transcoder)`
`<T> boolean`	`set(String key, int exp, T value, Transcoder<T> transcoder, long timeout)` Store key-value item to memcached
`void`	`setAuthInfoMap(Map<InetSocketAddress,AuthInfo> map)` Configure auth info
`void`	`setBufferAllocator(BufferAllocator bufferAllocator)` Set the nio's ByteBuffer Allocator,use SimpleBufferAllocator by default.
`void`	`setConnectionPoolSize(int poolSize)` In a high concurrent enviroment,you may want to pool memcached clients.But a xmemcached client has to start a reactor thread and some thread pools,if you create too many clients,the cost is very large.
`void`	`setConnectTimeout(long connectTimeout)` Set the connect timeout,default is 1 minutes
`void`	`setEnableHealSession(boolean enableHealSession)` If the memcached dump or network error cause connection closed,xmemcached would try to heal the connection.You can disable this behaviour by using this method: `client.setEnableHealSession(false);` The default value is true.
`void`	`setEnableHeartBeat(boolean enableHeartBeat)` Whether to enable heart beat
`void`	`setFailureMode(boolean failureMode)` Configure wheather to set client in failure mode.If set it to true,that means you want to configure client in failure mode.
`void`	`setHealSessionInterval(long healConnectionInterval)` If the memcached dump or network error cause connection closed,xmemcached would try to heal the connection.The interval between reconnections is 2 seconds by default.
`void`	`setKeyProvider(KeyProvider keyProvider)` Set a key provider for pre-processing keys before sending them to memcached.
`void`	`setLoggingLevelVerbosity(InetSocketAddress address, int level)` Set the verbosity level of the memcached's logging output.This method will wait for reply.
`void`	`setLoggingLevelVerbosityWithNoReply(InetSocketAddress address, int level)` Set the verbosity level of the memcached's logging output.This method doesn't wait for reply from server
`void`	`setMergeFactor(int mergeFactor)` Set the merge factor,this factor determins how many 'get' commands would be merge to one multi-get command.default is 150
`void`	`setName(String name)` Set cache instance name
`void`	`setOpTimeout(long opTimeout)` set operation timeout,default is one second.
`void`	`setOptimizeGet(boolean optimizeGet)` Enable/Disable merge many get commands to one multi-get command.true is to enable it,false is to disable it.Default is true.Recommend users to enable it.
`void`	`setOptimizeMergeBuffer(boolean optimizeMergeBuffer)` Enable/Disable merge many command's buffers to one big buffer fit socket's send buffer size.Default is true.Recommend true.
`void`	`setPrimitiveAsString(boolean primitiveAsString)` Store all primitive type as string,defualt is false.
`void`	`setSanitizeKeys(boolean sanitizeKeys)` Enables/disables sanitizing keys by URLEncoding.
`void`	`setServerWeight(String server, int weight)` Set a memcached server's weight
`void`	`setTimeoutExceptionThreshold(int timeoutExceptionThreshold)` Set maximum number of timeout exception for closing connection.You can set it to be a large value to disable this feature.
`void`	`setTranscoder(Transcoder transcoder)` set transcoder
`void`	`setWithNoReply(String key, int exp, Object value)` Store key-value item to memcached,doesn't wait for reply
`<T> void`	`setWithNoReply(String key, int exp, T value, Transcoder<T> transcoder)`
`void`	`shutdown()`
`protected void`	`shutdown0()` For subclass override.
`Map<String,String>`	`stats(InetSocketAddress address)`
`Map<String,String>`	`stats(InetSocketAddress address, long timeout)` �ョ��瑰��emcached server缁��淇℃�
`boolean`	`touch(String key, int exp)` Set a new expiration time for an existing item,using default opTimeout second.
`boolean`	`touch(String key, int exp, long opTimeout)` Set a new expiration time for an existing item
`<T> T`	`withNamespace(String ns, MemcachedClientCallable<T> callable)` With the namespae to do something with current memcached client.All operations with memcached client done in callable will be under the namespace.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - sessionLocator
```
protected MemcachedSessionLocator sessionLocator
```
  - sessionComparator
```
protected MemcachedSessionComparator sessionComparator
```
  - connector
```
protected MemcachedConnector connector
```
  - commandFactory
```
protected CommandFactory commandFactory
```
  - opTimeout
```
protected long opTimeout
```
  - connectionPoolSize
```
protected int connectionPoolSize
```
  - maxQueuedNoReplyOperations
```
protected int maxQueuedNoReplyOperations
```
  - resolveInetAddresses
```
protected boolean resolveInetAddresses
```
  - serverOrderCount
```
protected final AtomicInteger serverOrderCount
```
  - NAMESPACE_LOCAL
```
public static final ThreadLocal<String> NAMESPACE_LOCAL
```
    namespace thread local.
- Constructor Detail
  - XMemcachedClient
```
public XMemcachedClient(String server,
                int port)
                 throws IOException
```
    XMemcached constructor,default weight is 1
    
    Parameters:
    server - ��P
    port - ��ㄧ��
    
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(String host,
                int port,
                int weight)
                 throws IOException
```
    XMemcached constructor
    
    Parameters:
    host - server host
    port - server port
    weight - server weight
    
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(InetSocketAddress inetSocketAddress,
                int weight,
                CommandFactory cmdFactory)
                 throws IOException
```
    XMemcached Constructor.
    
    Parameters:
    inetSocketAddress -
    weight -
    
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(InetSocketAddress inetSocketAddress,
                int weight)
                 throws IOException
```
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(InetSocketAddress inetSocketAddress)
                 throws IOException
```
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient()
                 throws IOException
```
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(MemcachedSessionLocator locator,
                MemcachedSessionComparator comparator,
                BufferAllocator allocator,
                Configuration conf,
                Map<SocketOption,Object> socketOptions,
                CommandFactory commandFactory,
                Transcoder transcoder,
                Map<InetSocketAddress,InetSocketAddress> addressMap,
                List<MemcachedClientStateListener> stateListeners,
                Map<InetSocketAddress,AuthInfo> map,
                int poolSize,
                long connectTimeout,
                String name,
                boolean failureMode,
                boolean resolveInetAddresses)
                 throws IOException
```
    XMemcachedClient constructor.Every server's weight is one by default. You should not new client instance by this method, use MemcachedClientBuilder instead.
    
    Parameters:
    locator -
    comparator -
    allocator -
    conf -
    commandFactory -
    transcoder -
    addressList -
    stateListeners -
    
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(List<InetSocketAddress> addressList)
                 throws IOException
```
    XMemcached Constructor.Every server's weight is one by default.
    
    Parameters:
    addressList -
    
    Throws:
    
    IOException
  - XMemcachedClient
```
public XMemcachedClient(List<InetSocketAddress> addressList,
                CommandFactory cmdFactory)
                 throws IOException
```
    XMemcached Constructor.Every server's weight is one by default.
    
    Parameters:
    cmdFactory - command factory
    addressList - memcached server socket address list.
    
    Throws:
    
    IOException
- Method Detail
  - setMergeFactor
```
public final void setMergeFactor(int mergeFactor)
```
    Description copied from interface: MemcachedClient
    
    Set the merge factor,this factor determins how many 'get' commands would be merge to one multi-get command.default is 150
    
    Specified by:
    
    setMergeFactor in interface MemcachedClient
  - getTimeoutExceptionThreshold
```
public int getTimeoutExceptionThreshold()
```
    Description copied from interface: MemcachedClient
    
    Returns maximum number of timeout exception for closing connection.
    
    Specified by:
    
    getTimeoutExceptionThreshold in interface MemcachedClient
    
    Returns:
  - setTimeoutExceptionThreshold
```
public void setTimeoutExceptionThreshold(int timeoutExceptionThreshold)
```
    Description copied from interface: MemcachedClient
    
    Set maximum number of timeout exception for closing connection.You can set it to be a large value to disable this feature.
    
    Specified by:
    
    setTimeoutExceptionThreshold in interface MemcachedClient
    
    See Also:
    MemcachedClient.DEFAULT_MAX_TIMEOUTEXCEPTION_THRESHOLD
  - withNamespace
```
public <T> T withNamespace(String ns,
                  MemcachedClientCallable<T> callable)
                throws MemcachedException,
                       InterruptedException,
                       TimeoutException
```
    Description copied from interface: MemcachedClient
    With the namespae to do something with current memcached client.All operations with memcached client done in callable will be under the namespace. MemcachedClient.beginWithNamespace(String) and MemcachedClient.endWithNamespace() will called around automatically. For example:
```
   memcachedClient.withNamespace(userId,new MemcachedClientCallable{
     public Void call(MemcachedClient client) throws MemcachedException,
        InterruptedException, TimeoutException{
      client.set("username",0,username);
      client.set("email",0,email);
      return null;
     }
   });
   //invalidate all items under the namespace.
   memcachedClient.invalidateNamespace(userId);
 
```
    Specified by:
    
    withNamespace in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
    See Also:
    MemcachedClient.beginWithNamespace(String), MemcachedClient.endWithNamespace()
  - endWithNamespace
```
public void endWithNamespace()
```
    Description copied from interface: MemcachedClient
    
    Remove current namespace set for this memcached client.It must begin with MemcachedClient.beginWithNamespace(String) method.
    
    Specified by:
    
    endWithNamespace in interface MemcachedClient
    
    See Also:
    MemcachedClient.beginWithNamespace(String)
  - beginWithNamespace
```
public void beginWithNamespace(String ns)
```
    Description copied from interface: MemcachedClient
    set current namespace for following operations with memcached client.It must be ended with MemcachedClient.endWithNamespace() method.For example:
```
 memcachedClient.beginWithNamespace(userId);
 try {
   memcachedClient.set("username", 0, username);
   memcachedClient.set("email", 0, email);
 } finally {
   memcachedClient.endWithNamespace();
 }
 
```
    Specified by:
    
    beginWithNamespace in interface MemcachedClient
    
    See Also:
    MemcachedClient.endWithNamespace(), MemcachedClient.withNamespace(String, MemcachedClientCallable)
  - getKeyProvider
```
public KeyProvider getKeyProvider()
```
  - setKeyProvider
```
public void setKeyProvider(KeyProvider keyProvider)
```
    Description copied from interface: MemcachedClient
    
    Set a key provider for pre-processing keys before sending them to memcached.
    
    Specified by:
    
    setKeyProvider in interface MemcachedClient
  - getSessionLocator
```
public final MemcachedSessionLocator getSessionLocator()
```
  - getSessionComparator
```
public final MemcachedSessionComparator getSessionComparator()
```
  - getCommandFactory
```
public final CommandFactory getCommandFactory()
```
  - getName
```
public String getName()
```
    Description copied from interface: XMemcachedClientMBean
    
    Return the cache instance name
    
    Specified by:
    
    getName in interface MemcachedClient
    
    Specified by:
    
    getName in interface XMemcachedClientMBean
    
    Returns:
  - setName
```
public void setName(String name)
```
    Description copied from interface: MemcachedClient
    
    Set cache instance name
    
    Specified by:
    
    setName in interface MemcachedClient
  - getConnectTimeout
```
public long getConnectTimeout()
```
    Description copied from interface: MemcachedClient
    
    Get the connect timeout
    
    Specified by:
    
    getConnectTimeout in interface MemcachedClient
  - setConnectTimeout
```
public void setConnectTimeout(long connectTimeout)
```
    Description copied from interface: MemcachedClient
    
    Set the connect timeout,default is 1 minutes
    
    Specified by:
    
    setConnectTimeout in interface MemcachedClient
  - setEnableHeartBeat
```
public void setEnableHeartBeat(boolean enableHeartBeat)
```
    Description copied from interface: MemcachedClient
    
    Whether to enable heart beat
    
    Specified by:
    
    setEnableHeartBeat in interface MemcachedClient
    
    Parameters:
    enableHeartBeat - if true,then enable heartbeat,true by default
  - getOpTimeout
```
public final long getOpTimeout()
```
    get operation timeout setting
    
    Specified by:
    
    getOpTimeout in interface MemcachedClient
    
    Returns:
  - setOpTimeout
```
public final void setOpTimeout(long opTimeout)
```
    set operation timeout,default is one second.
    
    Specified by:
    
    setOpTimeout in interface MemcachedClient
    
    Parameters:
    opTimeout -
  - setHealSessionInterval
```
public void setHealSessionInterval(long healConnectionInterval)
```
    Description copied from interface: MemcachedClient
    
    If the memcached dump or network error cause connection closed,xmemcached would try to heal the connection.The interval between reconnections is 2 seconds by default. You can change that value by this method.
    
    Specified by:
    
    setHealSessionInterval in interface MemcachedClient
    
    Parameters:
    healConnectionInterval - MILLISECONDS
  - getHealSessionInterval
```
public long getHealSessionInterval()
```
    Description copied from interface: MemcachedClient
    
    Return the default heal session interval in milliseconds
    
    Specified by:
    
    getHealSessionInterval in interface MemcachedClient
    
    Returns:
  - getAuthInfoMap
```
public Map<InetSocketAddress,AuthInfo> getAuthInfoMap()
```
    Description copied from interface: MemcachedClient
    
    return current all auth info
    
    Specified by:
    
    getAuthInfoMap in interface MemcachedClient
    
    Returns:
    Auth info map,key is memcached server address,and value is the auth info for the key.
  - setAuthInfoMap
```
public void setAuthInfoMap(Map<InetSocketAddress,AuthInfo> map)
```
    Description copied from interface: MemcachedClient
    
    Configure auth info
    
    Specified by:
    
    setAuthInfoMap in interface MemcachedClient
    
    Parameters:
    map - Auth info map,key is memcached server address,and value is the auth info for the key.
  - getAuthInfoStringMap
```
public Map<String,AuthInfo> getAuthInfoStringMap()
```
    Description copied from interface: MemcachedClient
    
    Retruns the AuthInfo for all server strings (hostname:port)
    
    Specified by:
    
    getAuthInfoStringMap in interface MemcachedClient
    
    Returns:
    A map of AuthInfos for server strings (hostname:port)
  - getConnector
```
public final Connector getConnector()
```
    Description copied from interface: MemcachedClient
    
    return the session manager
    
    Specified by:
    
    getConnector in interface MemcachedClient
    
    Returns:
  - setOptimizeMergeBuffer
```
public final void setOptimizeMergeBuffer(boolean optimizeMergeBuffer)
```
    Description copied from interface: MemcachedClient
    
    Enable/Disable merge many command's buffers to one big buffer fit socket's send buffer size.Default is true.Recommend true.
    
    Specified by:
    
    setOptimizeMergeBuffer in interface MemcachedClient
  - isShutdown
```
public final boolean isShutdown()
```
    Specified by:
    
    isShutdown in interface MemcachedClient
    
    Returns:
  - sendCommand
```
protected final Session sendCommand(Command cmd)
                             throws MemcachedException
```
    Throws:
    
    MemcachedException
  - newSocketAddress
```
protected InetSocketAddress newSocketAddress(String server,
                                 int port)
```
  - addServer
```
public final void addServer(String server,
             int port)
                     throws IOException
```
    Description copied from interface: MemcachedClient
    
    Aadd a memcached server,the thread call this method will be blocked until the connecting operations completed(success or fail)
    
    Specified by:
    
    addServer in interface MemcachedClient
    
    Parameters:
    server - host string
    port - port number
    
    Throws:
    
    IOException
  - addServer
```
public final void addServer(String server,
             int port,
             int weight)
                     throws IOException
```
    add a memcached server to MemcachedClient
    
    Specified by:
    
    addServer in interface MemcachedClient
    
    Parameters:
    server -
    port -
    weight -
    
    Throws:
    
    IOException
  - addServer
```
public final void addServer(InetSocketAddress inetSocketAddress)
                     throws IOException
```
    Description copied from interface: MemcachedClient
    
    Add a memcached server,the thread call this method will be blocked until the connecting operations completed(success or fail)
    
    Specified by:
    
    addServer in interface MemcachedClient
    
    Parameters:
    inetSocketAddress - memcached server's socket address
    
    Throws:
    
    IOException
  - addServer
```
public final void addServer(InetSocketAddress inetSocketAddress,
             int weight)
                     throws IOException
```
    Specified by:
    
    addServer in interface MemcachedClient
    
    Throws:
    
    IOException
  - addServer
```
public final void addServer(String hostList)
                     throws IOException
```
    Description copied from interface: XMemcachedClientMBean
    
    Add memcached servers
    
    Specified by:
    
    addServer in interface MemcachedClient
    
    Specified by:
    
    addServer in interface XMemcachedClientMBean
    
    Throws:
    
    IOException
  - addOneServerWithWeight
```
public void addOneServerWithWeight(String server,
                          int weight)
                            throws IOException
```
    Description copied from interface: XMemcachedClientMBean
    
    Add a memcached server
    
    Specified by:
    
    addOneServerWithWeight in interface XMemcachedClientMBean
    
    Parameters:
    server - a String in the form of "[host1]:[port1],[host2]:[port2]"
    weight - server's weight
    
    Throws:
    
    IOException
  - getServersDescription
```
public final List<String> getServersDescription()
```
    Description copied from interface: XMemcachedClientMBean
    
    Get all connected memcached servers
    
    Specified by:
    
    getServersDescription in interface MemcachedClient
    
    Specified by:
    
    getServersDescription in interface XMemcachedClientMBean
    
    Returns:
    a list of string,every string is in the form of "[host1]:[port1](weight=num1) [host2]:[port2](weight=num1)"
  - setServerWeight
```
public final void setServerWeight(String server,
                   int weight)
```
    Description copied from interface: XMemcachedClientMBean
    
    Set a memcached server's weight
    
    Specified by:
    
    setServerWeight in interface XMemcachedClientMBean
  - removeServer
```
public final void removeServer(String hostList)
```
    Description copied from interface: XMemcachedClientMBean
    
    Remove memcached servers
    
    Specified by:
    
    removeServer in interface MemcachedClient
    
    Specified by:
    
    removeServer in interface XMemcachedClientMBean
  - removeServer
```
public void removeServer(InetSocketAddress address)
```
    Description copied from interface: MemcachedClient
    
    Remove memcached server with the exact given address.
    
    Specified by:
    
    removeServer in interface MemcachedClient
    
    Parameters:
    address - Resolved server address
  - connect
```
protected void connect(InetSocketAddressWrapper inetSocketAddressWrapper)
                throws IOException
```
    Throws:
    
    IOException
  - newConnector
```
protected MemcachedConnector newConnector(BufferAllocator bufferAllocator,
                              Configuration configuration,
                              MemcachedSessionLocator memcachedSessionLocator,
                              MemcachedSessionComparator memcachedSessionComparator,
                              CommandFactory commandFactory,
                              int poolSize,
                              int maxQueuedNoReplyOperations)
```
  - setOptimizeGet
```
public void setOptimizeGet(boolean optimizeGet)
```
    Description copied from interface: MemcachedClient
    
    Enable/Disable merge many get commands to one multi-get command.true is to enable it,false is to disable it.Default is true.Recommend users to enable it.
    
    Specified by:
    
    setOptimizeGet in interface MemcachedClient
  - setBufferAllocator
```
public final void setBufferAllocator(BufferAllocator bufferAllocator)
```
    Description copied from interface: MemcachedClient
    
    Set the nio's ByteBuffer Allocator,use SimpleBufferAllocator by default.
    
    Specified by:
    
    setBufferAllocator in interface MemcachedClient
  - get
```
public final <T> T get(String key,
        long timeout,
        Transcoder<T> transcoder)
            throws TimeoutException,
                   InterruptedException,
                   MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Get value by key
    
    Specified by:
    
    get in interface MemcachedClient
    
    Parameters:
    key - Key
    timeout - Operation timeout,if the method is not returned in this time,throw TimeoutException
    transcoder - The value's transcoder
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - get
```
public final <T> T get(String key,
        long timeout)
            throws TimeoutException,
                   InterruptedException,
                   MemcachedException
```
    Specified by:
    
    get in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - get
```
public final <T> T get(String key,
        Transcoder<T> transcoder)
            throws TimeoutException,
                   InterruptedException,
                   MemcachedException
```
    Specified by:
    
    get in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - get
```
public final <T> T get(String key)
            throws TimeoutException,
                   InterruptedException,
                   MemcachedException
```
    Specified by:
    
    get in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - gets
```
public final <T> GetsResponse<T> gets(String key,
                       long timeout,
                       Transcoder<T> transcoder)
                           throws TimeoutException,
                                  InterruptedException,
                                  MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Just like get,But it return a GetsResponse,include cas value for cas update.
    
    Specified by:
    
    gets in interface MemcachedClient
    
    Parameters:
    key - key
    timeout - operation timeout
    
    Returns:
    GetsResponse
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - gets
```
public final <T> GetsResponse<T> gets(String key)
                           throws TimeoutException,
                                  InterruptedException,
                                  MemcachedException
```
    Specified by:
    
    gets in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.gets(String, long, Transcoder)
  - gets
```
public final <T> GetsResponse<T> gets(String key,
                       long timeout)
                           throws TimeoutException,
                                  InterruptedException,
                                  MemcachedException
```
    Specified by:
    
    gets in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.gets(String, long, Transcoder)
  - gets
```
public final <T> GetsResponse<T> gets(String key,
                       Transcoder transcoder)
                           throws TimeoutException,
                                  InterruptedException,
                                  MemcachedException
```
    Specified by:
    
    gets in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.gets(String, long, Transcoder)
  - get
```
public final <T> Map<String,T> get(Collection<String> keyCollections,
                    long timeout,
                    Transcoder<T> transcoder)
                        throws TimeoutException,
                               InterruptedException,
                               MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Bulk get items
    
    Specified by:
    
    get in interface MemcachedClient
    
    Parameters:
    keyCollections - key collection
    timeout - opTimeout
    transcoder - Value transcoder
    
    Returns:
    Exists items map
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - get
```
public final <T> Map<String,T> get(Collection<String> keyCollections,
                    Transcoder<T> transcoder)
                        throws TimeoutException,
                               InterruptedException,
                               MemcachedException
```
    Specified by:
    
    get in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.get(Collection, long, Transcoder)
  - get
```
public final <T> Map<String,T> get(Collection<String> keyCollections)
                        throws TimeoutException,
                               InterruptedException,
                               MemcachedException
```
    Specified by:
    
    get in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.get(Collection, long, Transcoder)
  - get
```
public final <T> Map<String,T> get(Collection<String> keyCollections,
                    long timeout)
                        throws TimeoutException,
                               InterruptedException,
                               MemcachedException
```
    Specified by:
    
    get in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.get(Collection, long, Transcoder)
  - gets
```
public final <T> Map<String,GetsResponse<T>> gets(Collection<String> keyCollections,
                                   long timeout,
                                   Transcoder<T> transcoder)
                                       throws TimeoutException,
                                              InterruptedException,
                                              MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Bulk gets items
    
    Specified by:
    
    gets in interface MemcachedClient
    
    Parameters:
    keyCollections - key collection
    timeout - Operation timeout
    transcoder - Value transcoder
    
    Returns:
    Exists GetsResponse map
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    GetsResponse
  - gets
```
public final <T> Map<String,GetsResponse<T>> gets(Collection<String> keyCollections)
                                       throws TimeoutException,
                                              InterruptedException,
                                              MemcachedException
```
    Specified by:
    
    gets in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.gets(Collection, long, Transcoder)
  - gets
```
public final <T> Map<String,GetsResponse<T>> gets(Collection<String> keyCollections,
                                   long timeout)
                                       throws TimeoutException,
                                              InterruptedException,
                                              MemcachedException
```
    Specified by:
    
    gets in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.gets(Collection, long, Transcoder)
  - gets
```
public final <T> Map<String,GetsResponse<T>> gets(Collection<String> keyCollections,
                                   Transcoder<T> transcoder)
                                       throws TimeoutException,
                                              InterruptedException,
                                              MemcachedException
```
    Specified by:
    
    gets in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.gets(Collection, long, Transcoder)
  - set
```
public final <T> boolean set(String key,
              int exp,
              T value,
              Transcoder<T> transcoder,
              long timeout)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Store key-value item to memcached
    
    Specified by:
    
    set in interface MemcachedClient
    
    Parameters:
    key - stored key
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    value - stored data
    transcoder - transocder
    timeout - operation timeout,in milliseconds
    
    Returns:
    boolean result
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - setWithNoReply
```
public void setWithNoReply(String key,
                  int exp,
                  Object value)
                    throws InterruptedException,
                           MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Store key-value item to memcached,doesn't wait for reply
    
    Specified by:
    
    setWithNoReply in interface MemcachedClient
    
    Parameters:
    key - stored key
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    value - stored data
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - setWithNoReply
```
public <T> void setWithNoReply(String key,
                      int exp,
                      T value,
                      Transcoder<T> transcoder)
                    throws InterruptedException,
                           MemcachedException
```
    Specified by:
    
    setWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.setWithNoReply(String, int, Object, Transcoder)
  - set
```
public final boolean set(String key,
          int exp,
          Object value)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    set in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.set(String, int, Object, Transcoder, long)
  - set
```
public final boolean set(String key,
          int exp,
          Object value,
          long timeout)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    set in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.set(String, int, Object, Transcoder, long)
  - set
```
public final <T> boolean set(String key,
              int exp,
              T value,
              Transcoder<T> transcoder)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    set in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.set(String, int, Object, Transcoder, long)
  - add
```
public final <T> boolean add(String key,
              int exp,
              T value,
              Transcoder<T> transcoder,
              long timeout)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Add key-value item to memcached, success only when the key is not exists in memcached.
    
    Specified by:
    
    add in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Returns:
    boolean result
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - add
```
public final boolean add(String key,
          int exp,
          Object value)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    add in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.add(String, int, Object, Transcoder, long)
  - add
```
public final boolean add(String key,
          int exp,
          Object value,
          long timeout)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    add in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.add(String, int, Object, Transcoder, long)
  - add
```
public final <T> boolean add(String key,
              int exp,
              T value,
              Transcoder<T> transcoder)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    add in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.add(String, int, Object, Transcoder, long)
  - addWithNoReply
```
public void addWithNoReply(String key,
                  int exp,
                  Object value)
                    throws InterruptedException,
                           MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Add key-value item to memcached, success only when the key is not exists in memcached.This method doesn't wait for reply.
    
    Specified by:
    
    addWithNoReply in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - addWithNoReply
```
public <T> void addWithNoReply(String key,
                      int exp,
                      T value,
                      Transcoder<T> transcoder)
                    throws InterruptedException,
                           MemcachedException
```
    Specified by:
    
    addWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.addWithNoReply(String, int, Object, Transcoder)
  - replaceWithNoReply
```
public void replaceWithNoReply(String key,
                      int exp,
                      Object value)
                        throws InterruptedException,
                               MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Replace the key's data item in memcached,success only when the key's data item is exists in memcached.This method doesn't wait for reply from server.
    
    Specified by:
    
    replaceWithNoReply in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - replaceWithNoReply
```
public <T> void replaceWithNoReply(String key,
                          int exp,
                          T value,
                          Transcoder<T> transcoder)
                        throws InterruptedException,
                               MemcachedException
```
    Specified by:
    
    replaceWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.replaceWithNoReply(String, int, Object, Transcoder)
  - replace
```
public final <T> boolean replace(String key,
                  int exp,
                  T value,
                  Transcoder<T> transcoder,
                  long timeout)
                      throws TimeoutException,
                             InterruptedException,
                             MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Replace the key's data item in memcached,success only when the key's data item is exists in memcached.This method will wait for reply from server.
    
    Specified by:
    
    replace in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Returns:
    boolean result
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - replace
```
public final boolean replace(String key,
              int exp,
              Object value)
                      throws TimeoutException,
                             InterruptedException,
                             MemcachedException
```
    Specified by:
    
    replace in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.replace(String, int, Object, Transcoder, long)
  - replace
```
public final boolean replace(String key,
              int exp,
              Object value,
              long timeout)
                      throws TimeoutException,
                             InterruptedException,
                             MemcachedException
```
    Specified by:
    
    replace in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.replace(String, int, Object, Transcoder, long)
  - replace
```
public final <T> boolean replace(String key,
                  int exp,
                  T value,
                  Transcoder<T> transcoder)
                      throws TimeoutException,
                             InterruptedException,
                             MemcachedException
```
    Specified by:
    
    replace in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.replace(String, int, Object, Transcoder, long)
  - append
```
public final boolean append(String key,
             Object value)
                     throws TimeoutException,
                            InterruptedException,
                            MemcachedException
```
    Specified by:
    
    append in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.append(String, Object, long)
  - append
```
public final boolean append(String key,
             Object value,
             long timeout)
                     throws TimeoutException,
                            InterruptedException,
                            MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Append value to key's data item,this method will wait for reply
    
    Specified by:
    
    append in interface MemcachedClient
    
    Returns:
    boolean result
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - appendWithNoReply
```
public void appendWithNoReply(String key,
                     Object value)
                       throws InterruptedException,
                              MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Append value to key's data item,this method doesn't wait for reply.
    
    Specified by:
    
    appendWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - prepend
```
public final boolean prepend(String key,
              Object value)
                      throws TimeoutException,
                             InterruptedException,
                             MemcachedException
```
    Specified by:
    
    prepend in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.prepend(String, Object, long)
  - prepend
```
public final boolean prepend(String key,
              Object value,
              long timeout)
                      throws TimeoutException,
                             InterruptedException,
                             MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Prepend value to key's data item in memcached.This method doesn't wait for reply.
    
    Specified by:
    
    prepend in interface MemcachedClient
    
    Returns:
    boolean result
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - prependWithNoReply
```
public void prependWithNoReply(String key,
                      Object value)
                        throws InterruptedException,
                               MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Prepend value to key's data item in memcached.This method doesn't wait for reply.
    
    Specified by:
    
    prependWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - cas
```
public final boolean cas(String key,
          int exp,
          Object value,
          long cas)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, Object, Transcoder, long, long)
  - cas
```
public final <T> boolean cas(String key,
              int exp,
              T value,
              Transcoder<T> transcoder,
              long timeout,
              long cas)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Cas is a check and set operation which means "store this data but only if no one else has updated since I last fetched it."
    
    Specified by:
    
    cas in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - cas
```
public final boolean cas(String key,
          int exp,
          Object value,
          long timeout,
          long cas)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, Object, Transcoder, long, long)
  - cas
```
public final <T> boolean cas(String key,
              int exp,
              T value,
              Transcoder<T> transcoder,
              long cas)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, Object, Transcoder, long, long)
  - cas
```
public final <T> boolean cas(String key,
              int exp,
              CASOperation<T> operation,
              Transcoder<T> transcoder)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Cas is a check and set operation which means "store this data but only if no one else has updated since I last fetched it."
    
    Specified by:
    
    cas in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    operation - CASOperation
    transcoder - object transcoder
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - cas
```
public final <T> boolean cas(String key,
              int exp,
              GetsResponse<T> getsReponse,
              CASOperation<T> operation,
              Transcoder<T> transcoder)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Description copied from interface: MemcachedClient
    
    cas is a check and set operation which means "store this data but only if no one else has updated since I last fetched it."
    
    Specified by:
    
    cas in interface MemcachedClient
    
    exp - An expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    getsReponse - gets method's result
    operation - CASOperation
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - cas
```
public final <T> boolean cas(String key,
              int exp,
              GetsResponse<T> getsReponse,
              CASOperation<T> operation)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, GetsResponse, CASOperation, Transcoder)
  - casWithNoReply
```
public <T> void casWithNoReply(String key,
                      CASOperation<T> operation)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Specified by:
    
    casWithNoReply in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.casWithNoReply(String, int, GetsResponse, CASOperation)
  - casWithNoReply
```
public <T> void casWithNoReply(String key,
                      GetsResponse<T> getsResponse,
                      CASOperation<T> operation)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Specified by:
    
    casWithNoReply in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - casWithNoReply
```
public <T> void casWithNoReply(String key,
                      int exp,
                      CASOperation<T> operation)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Specified by:
    
    casWithNoReply in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.casWithNoReply(String, int, GetsResponse, CASOperation)
  - casWithNoReply
```
public <T> void casWithNoReply(String key,
                      int exp,
                      GetsResponse<T> getsReponse,
                      CASOperation<T> operation)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Description copied from interface: MemcachedClient
    
    cas noreply
    
    Specified by:
    
    casWithNoReply in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - cas
```
public final <T> boolean cas(String key,
              GetsResponse<T> getsReponse,
              CASOperation<T> operation)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, GetsResponse, CASOperation, Transcoder)
  - cas
```
public final <T> boolean cas(String key,
              int exp,
              CASOperation<T> operation)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, GetsResponse, CASOperation, Transcoder)
  - cas
```
public final <T> boolean cas(String key,
              CASOperation<T> operation)
                  throws TimeoutException,
                         InterruptedException,
                         MemcachedException
```
    Specified by:
    
    cas in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    MemcachedClient.cas(String, int, GetsResponse, CASOperation, Transcoder)
  - delete
```
public final boolean delete(String key,
             int time)
                     throws TimeoutException,
                            InterruptedException,
                            MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Delete key's data item from memcached.It it is not exists,return false.
    time is the amount of time in seconds (or Unix time until
    which) the client wishes the server to refuse "add" and "replace"
    commands with this key. For this amount of item, the item is put into a
    delete queue, which means that it won't possible to retrieve it by the
    "get" command, but "add" and "replace" command with this key will also
    fail (the "set" command will succeed, however). After the time passes,
    the item is finally deleted from server memory.
    Note: This method is deprecated,because memcached 1.4.0 remove the optional argument "time".You can still use this method on old version,but is not recommended.
    
    Specified by:
    
    delete in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
    
    TimeoutException
  - delete
```
public boolean delete(String key,
             long opTimeout)
               throws TimeoutException,
                      InterruptedException,
                      MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Delete key's date item from memcached
    
    Specified by:
    
    delete in interface MemcachedClient
    
    opTimeout - Operation timeout
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - delete
```
public boolean delete(String key,
             long cas,
             long opTimeout)
               throws TimeoutException,
                      InterruptedException,
                      MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Delete key's date item from memcached only if its cas value is the same as what was read.
    
    Specified by:
    
    delete in interface MemcachedClient
    
    opTimeout - Operation timeout
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - deleteWithNoReply
```
public final void deleteWithNoReply(String key,
                     int time)
                             throws InterruptedException,
                                    MemcachedException
```
    Delete key's data item from memcached.This method doesn't wait for reply
    
    Specified by:
    
    deleteWithNoReply in interface MemcachedClient
    
    Parameters:
    key -
    time -
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - deleteWithNoReply
```
public final void deleteWithNoReply(String key)
                             throws InterruptedException,
                                    MemcachedException
```
    Specified by:
    
    deleteWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - checkException
```
protected void checkException(Command command)
                       throws MemcachedException
```
    Throws:
    
    MemcachedException
  - touch
```
public boolean touch(String key,
            int exp,
            long opTimeout)
              throws TimeoutException,
                     InterruptedException,
                     MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Set a new expiration time for an existing item
    
    Specified by:
    
    touch in interface MemcachedClient
    
    Parameters:
    key - item's key
    exp - New expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    opTimeout - operation timeout
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - touch
```
public boolean touch(String key,
            int exp)
              throws TimeoutException,
                     InterruptedException,
                     MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Set a new expiration time for an existing item,using default opTimeout second.
    
    Specified by:
    
    touch in interface MemcachedClient
    
    Parameters:
    key - item's key
    exp - New expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - getAndTouch
```
public <T> T getAndTouch(String key,
                int newExp,
                long opTimeout)
              throws TimeoutException,
                     InterruptedException,
                     MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Get item and set a new expiration time for it
    
    Specified by:
    
    getAndTouch in interface MemcachedClient
    
    Parameters:
    key - item's key
    newExp - New expiration time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    opTimeout - operation timeout
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - getAndTouch
```
public <T> T getAndTouch(String key,
                int newExp)
              throws TimeoutException,
                     InterruptedException,
                     MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Get item and set a new expiration time for it,using default opTimeout
    
    Specified by:
    
    getAndTouch in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - incr
```
public final long incr(String key,
        long delta)
                throws TimeoutException,
                       InterruptedException,
                       MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "incr" are used to change data for some item in-place, incrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for incr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    incr in interface MemcachedClient
    
    Returns:
    the new value of the item's data, after the increment operation was carried out.
    
    Throws:
    
    InterruptedException
    
    MemcachedException
    
    TimeoutException
  - incr
```
public long incr(String key,
        long delta,
        long initValue)
          throws TimeoutException,
                 InterruptedException,
                 MemcachedException
```
    Specified by:
    
    incr in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - incr
```
public long incr(String key,
        long delta,
        long initValue,
        long timeout)
          throws TimeoutException,
                 InterruptedException,
                 MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "incr" are used to change data for some item in-place, incrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for incr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    incr in interface MemcachedClient
    
    Parameters:
    key - key
    initValue - initValue if the data is not exists.
    timeout - operation timeout
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - incr
```
public long incr(String key,
        long delta,
        long initValue,
        long timeout,
        int exp)
          throws TimeoutException,
                 InterruptedException,
                 MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "incr" are used to change data for some item in-place, incrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for incr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    incr in interface MemcachedClient
    
    Parameters:
    key - key
    delta - increment delta
    initValue - the initial value to be added when value is not found
    timeout - operation timeout
    exp - the initial vlaue expire time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - incrWithNoReply
```
public final void incrWithNoReply(String key,
                   long delta)
                           throws InterruptedException,
                                  MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "incr" are used to change data for some item in-place, incrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for incr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    incrWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - decrWithNoReply
```
public final void decrWithNoReply(String key,
                   long delta)
                           throws InterruptedException,
                                  MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "decr" are used to change data for some item in-place, decrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for decr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    decrWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - decr
```
public final long decr(String key,
        long delta)
                throws TimeoutException,
                       InterruptedException,
                       MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "decr" are used to change data for some item in-place, decrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for decr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    decr in interface MemcachedClient
    
    Returns:
    the new value of the item's data, after the decrement operation was carried out.
    
    Throws:
    
    InterruptedException
    
    MemcachedException
    
    TimeoutException
  - decr
```
public long decr(String key,
        long delta,
        long initValue)
          throws TimeoutException,
                 InterruptedException,
                 MemcachedException
```
    Specified by:
    
    decr in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
    See Also:
    decr
  - decr
```
public long decr(String key,
        long delta,
        long initValue,
        long timeout)
          throws TimeoutException,
                 InterruptedException,
                 MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "decr" are used to change data for some item in-place, decrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for decr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    decr in interface MemcachedClient
    
    Parameters:
    key - The key
    initValue - The initial value if the data is not exists.
    timeout - Operation timeout
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - decr
```
public long decr(String key,
        long delta,
        long initValue,
        long timeout,
        int exp)
          throws TimeoutException,
                 InterruptedException,
                 MemcachedException
```
    Description copied from interface: MemcachedClient
    
    "incr" are used to change data for some item in-place, incrementing it. The data for the item is treated as decimal representation of a 64-bit unsigned integer. If the current data value does not conform to such a representation, the commands behave as if the value were 0. Also, the item must already exist for incr to work; these commands won't pretend that a non-existent key exists with value 0; instead, it will fail.This method doesn't wait for reply.
    
    Specified by:
    
    decr in interface MemcachedClient
    
    initValue - the initial value to be added when value is not found
    exp - the initial vlaue expire time, in seconds. Can be up to 30 days. After 30 days, is treated as a unix timestamp of an exact date.
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - flushAll
```
public final void flushAll()
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Make All connected memcached's data item invalid
    
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - flushAllWithNoReply
```
public void flushAllWithNoReply()
                         throws InterruptedException,
                                MemcachedException
```
    Specified by:
    
    flushAllWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - flushAllWithNoReply
```
public void flushAllWithNoReply(int exptime)
                         throws InterruptedException,
                                MemcachedException
```
    Specified by:
    
    flushAllWithNoReply in interface MemcachedClient
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - flushAllWithNoReply
```
public void flushAllWithNoReply(InetSocketAddress address)
                         throws MemcachedException,
                                InterruptedException
```
    Specified by:
    
    flushAllWithNoReply in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
  - flushAllWithNoReply
```
public void flushAllWithNoReply(InetSocketAddress address,
                       int exptime)
                         throws MemcachedException,
                                InterruptedException
```
    Specified by:
    
    flushAllWithNoReply in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
  - flushAll
```
public final void flushAll(int exptime,
            long timeout)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - flushAll
```
public final void flushAll(long timeout)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Make All connected memcached's data item invalid
    
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Parameters:
    timeout - operation timeout
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - setLoggingLevelVerbosity
```
public void setLoggingLevelVerbosity(InetSocketAddress address,
                            int level)
                              throws TimeoutException,
                                     InterruptedException,
                                     MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Set the verbosity level of the memcached's logging output.This method will wait for reply.
    
    Specified by:
    
    setLoggingLevelVerbosity in interface MemcachedClient
    
    level - logging level
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - setLoggingLevelVerbosityWithNoReply
```
public void setLoggingLevelVerbosityWithNoReply(InetSocketAddress address,
                                       int level)
                                         throws InterruptedException,
                                                MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Set the verbosity level of the memcached's logging output.This method doesn't wait for reply from server
    
    Specified by:
    
    setLoggingLevelVerbosityWithNoReply in interface MemcachedClient
    
    Parameters:
    address - memcached server address
    level - logging level
    
    Throws:
    
    InterruptedException
    
    MemcachedException
  - flushAll
```
public final void flushAll(InetSocketAddress address)
                    throws MemcachedException,
                           InterruptedException,
                           TimeoutException
```
    Description copied from interface: MemcachedClient
    
    Invalidate all existing items immediately
    
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Parameters:
    address - Target memcached server
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - flushAll
```
public final void flushAll(InetSocketAddress address,
            long timeout)
                    throws MemcachedException,
                           InterruptedException,
                           TimeoutException
```
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - flushAll
```
public final void flushAll(InetSocketAddress address,
            long timeout,
            int exptime)
                    throws MemcachedException,
                           InterruptedException,
                           TimeoutException
```
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - flushAll
```
public final void flushAll(String host)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Description copied from interface: MemcachedClient
    
    This method is deprecated,please use flushAll(InetSocketAddress) instead.
    
    Specified by:
    
    flushAll in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - stats
```
public final Map<String,String> stats(InetSocketAddress address)
                               throws MemcachedException,
                                      InterruptedException,
                                      TimeoutException
```
    Specified by:
    
    stats in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - stats
```
public final Map<String,String> stats(InetSocketAddress address,
                       long timeout)
                               throws MemcachedException,
                                      InterruptedException,
                                      TimeoutException
```
    Description copied from interface: MemcachedClient
    
    �ョ��瑰��emcached server缁��淇℃�
    
    Specified by:
    
    stats in interface MemcachedClient
    
    Parameters:
    address - ��板�
    timeout - ��瓒��
    
    Returns:
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - getStats
```
public final Map<InetSocketAddress,Map<String,String>> getStats()
                                                         throws MemcachedException,
                                                                InterruptedException,
                                                                TimeoutException
```
    Specified by:
    
    getStats in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - getStatsByItem
```
public final Map<InetSocketAddress,Map<String,String>> getStatsByItem(String itemName)
                                                               throws MemcachedException,
                                                                      InterruptedException,
                                                                      TimeoutException
```
    Description copied from interface: MemcachedClient
    
    Get special item stats. "stats items" for example
    
    Specified by:
    
    getStatsByItem in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - getStatsByItem
```
public final Map<InetSocketAddress,Map<String,String>> getStatsByItem(String itemName,
                                                       long timeout)
                                                               throws MemcachedException,
                                                                      InterruptedException,
                                                                      TimeoutException
```
    Specified by:
    
    getStatsByItem in interface MemcachedClient
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - getVersions
```
public final Map<InetSocketAddress,String> getVersions()
                                                throws TimeoutException,
                                                       InterruptedException,
                                                       MemcachedException
```
    Description copied from interface: MemcachedClient
    
    Get all connected memcached servers's version.
    
    Specified by:
    
    getVersions in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - getVersions
```
public final Map<InetSocketAddress,String> getVersions(long timeout)
                                                throws TimeoutException,
                                                       InterruptedException,
                                                       MemcachedException
```
    Specified by:
    
    getVersions in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - getStats
```
public Map<InetSocketAddress,Map<String,String>> getStats(long timeout)
                                                   throws MemcachedException,
                                                          InterruptedException,
                                                          TimeoutException
```
    Description copied from interface: MemcachedClient
    
    Get stats from all memcached servers
    
    Specified by:
    
    getStats in interface MemcachedClient
    
    Returns:
    server->item->value map
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - shutdown0
```
protected void shutdown0()
```
    For subclass override.
  - shutdown
```
public final void shutdown()
                    throws IOException
```
    Specified by:
    
    shutdown in interface MemcachedClient
    
    Throws:
    
    IOException
  - setConnectionPoolSize
```
public void setConnectionPoolSize(int poolSize)
```
    Description copied from interface: MemcachedClient
    
    In a high concurrent enviroment,you may want to pool memcached clients.But a xmemcached client has to start a reactor thread and some thread pools,if you create too many clients,the cost is very large. Xmemcached supports connection pool instreadof client pool.you can create more connections to one or more memcached servers,and these connections share the same reactor and thread pools,it will reduce the cost of system.
    
    Specified by:
    
    setConnectionPoolSize in interface MemcachedClient
    
    Parameters:
    poolSize - pool size,default is one,every memcached has only one connection.
  - delete
```
public final boolean delete(String key)
                     throws TimeoutException,
                            InterruptedException,
                            MemcachedException
```
    Specified by:
    
    delete in interface MemcachedClient
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - getTranscoder
```
public final Transcoder getTranscoder()
```
    Description copied from interface: MemcachedClient
    
    return default transcoder,default is SerializingTranscoder
    
    Specified by:
    
    getTranscoder in interface MemcachedClient
    
    Returns:
  - setTranscoder
```
public final void setTranscoder(Transcoder transcoder)
```
    Description copied from interface: MemcachedClient
    
    set transcoder
    
    Specified by:
    
    setTranscoder in interface MemcachedClient
  - latchWait
```
protected void latchWait(Command cmd,
             long timeout,
             Session session)
                  throws InterruptedException,
                         TimeoutException
```
    Throws:
    
    InterruptedException
    
    TimeoutException
  - getAvaliableServers
```
@Deprecated
public final Collection<InetSocketAddress> getAvaliableServers()
```
    Deprecated.
    
    Use getAvailableServers() instead
    
    Specified by:
    
    getAvaliableServers in interface MemcachedClient
    
    Returns:
    See Also:
    MemcachedClient.getAvailableServers()
  - getAvailableServers
```
public Collection<InetSocketAddress> getAvailableServers()
```
    Description copied from interface: MemcachedClient
    
    Returns available memcached servers list.
    
    Specified by:
    
    getAvailableServers in interface MemcachedClient
    
    Returns:
    A available server collection
  - getConnectionSizeBySocketAddress
```
public final int getConnectionSizeBySocketAddress(InetSocketAddress address)
```
  - addStateListener
```
public void addStateListener(MemcachedClientStateListener listener)
```
    Description copied from interface: MemcachedClient
    
    Add a memcached client listener
    
    Specified by:
    
    addStateListener in interface MemcachedClient
  - getStateListeners
```
public Collection<MemcachedClientStateListener> getStateListeners()
```
    Description copied from interface: MemcachedClient
    
    Get all current state listeners
    
    Specified by:
    
    getStateListeners in interface MemcachedClient
    
    Returns:
  - setPrimitiveAsString
```
public void setPrimitiveAsString(boolean primitiveAsString)
```
    Description copied from interface: MemcachedClient
    
    Store all primitive type as string,defualt is false.
    
    Specified by:
    
    setPrimitiveAsString in interface MemcachedClient
  - removeStateListener
```
public void removeStateListener(MemcachedClientStateListener listener)
```
    Description copied from interface: MemcachedClient
    
    Remove a memcached client listener
    
    Specified by:
    
    removeStateListener in interface MemcachedClient
  - getProtocol
```
public Protocol getProtocol()
```
    Specified by:
    
    getProtocol in interface MemcachedClient
  - isSanitizeKeys
```
public boolean isSanitizeKeys()
```
    Specified by:
    
    isSanitizeKeys in interface MemcachedClient
  - setSanitizeKeys
```
public void setSanitizeKeys(boolean sanitizeKeys)
```
    Description copied from interface: MemcachedClient
    
    Enables/disables sanitizing keys by URLEncoding.
    
    Specified by:
    
    setSanitizeKeys in interface MemcachedClient
    
    Parameters:
    sanitizeKeys - if true, then URLEncode all keys
  - invalidateNamespace
```
public void invalidateNamespace(String ns,
                       long opTimeout)
                         throws MemcachedException,
                                InterruptedException,
                                TimeoutException
```
    Description copied from interface: MemcachedClient
    
    Invalidate all items under the namespace.
    
    Specified by:
    
    invalidateNamespace in interface MemcachedClient
    
    Parameters:
    ns - the namespace
    opTimeout - operation timeout in milliseconds.
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - invalidateNamespace
```
public void invalidateNamespace(String ns)
                         throws MemcachedException,
                                InterruptedException,
                                TimeoutException
```
    Description copied from interface: MemcachedClient
    
    Invalidate all namespace under the namespace using the default operation timeout.
    
    Specified by:
    
    invalidateNamespace in interface MemcachedClient
    
    Parameters:
    ns - the namespace
    
    Throws:
    
    MemcachedException
    
    InterruptedException
    
    TimeoutException
  - getNamespace
```
public String getNamespace(String ns)
                    throws TimeoutException,
                           InterruptedException,
                           MemcachedException
```
    Returns the real namespace of ns.
    
    Parameters:
    ns -
    
    Returns:
    
    Throws:
    
    TimeoutException
    
    InterruptedException
    
    MemcachedException
  - getCounter
```
public Counter getCounter(String key,
                 long initialValue)
```
    Description copied from interface: MemcachedClient
    
    Get counter for key,and if the key's value is not set,then set it with initial value.
    
    Specified by:
    
    getCounter in interface MemcachedClient
    
    Returns:
  - getCounter
```
public Counter getCounter(String key)
```
    Description copied from interface: MemcachedClient
    
    Get counter for key,and if the key's value is not set,then set it with 0.
    
    Specified by:
    
    getCounter in interface MemcachedClient
    
    Returns:
  - getKeyIterator
```
@Deprecated
public KeyIterator getKeyIterator(InetSocketAddress address)
                           throws MemcachedException,
                                  TimeoutException,
                                  InterruptedException
```
    Deprecated. memcached 1.6.x will remove cachedump stats command,so this method will be removed in the future
    
    Description copied from interface: MemcachedClient
    
    Get key iterator for special memcached server.You must known that the iterator is a snapshot for memcached all keys,it is not real-time.The 'stats cachedump" has length limitation,so iterator could not visit all keys if you have many keys.Your application should not be dependent on this feature.
    
    Specified by:
    
    getKeyIterator in interface MemcachedClient
    
    Returns:
    
    Throws:
    
    MemcachedException
    
    TimeoutException
    
    InterruptedException
  - setEnableHealSession
```
public void setEnableHealSession(boolean enableHealSession)
```
    Description copied from interface: MemcachedClient
    
    If the memcached dump or network error cause connection closed,xmemcached would try to heal the connection.You can disable this behaviour by using this method:
    client.setEnableHealSession(false);
    The default value is true.
    
    Specified by:
    
    setEnableHealSession in interface MemcachedClient
  - setFailureMode
```
public void setFailureMode(boolean failureMode)
```
    Description copied from interface: MemcachedClient
    
    Configure wheather to set client in failure mode.If set it to true,that means you want to configure client in failure mode. Failure mode is that when a memcached server is down,it would not taken from the server list but marked as unavailable,and then further requests to this server will be transformed to standby node if configured or throw an exception until it comes back up.
    
    Specified by:
    
    setFailureMode in interface MemcachedClient
    
    Parameters:
    failureMode - true is to configure client in failure mode.
  - isFailureMode
```
public boolean isFailureMode()
```
    Description copied from interface: MemcachedClient
    
    Returns if client is in failure mode.
    
    Specified by:
    
    isFailureMode in interface MemcachedClient
    
    Returns:
  - getReconnectRequestQueue
```
public Queue<ReconnectRequest> getReconnectRequestQueue()
```
    Description copied from interface: MemcachedClient
    
    Returns reconnecting task queue,the queue is thread-safe and 'weakly consistent',but maybe you should not modify it at all.
    
    Specified by:
    
    getReconnectRequestQueue in interface MemcachedClient
    
    Returns:
    The reconnecting task queue,if the client has not been started,returns null.

Class XMemcachedClient

Field Summary

Fields inherited from interface net.rubyeye.xmemcached.MemcachedClient

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sessionLocator

sessionComparator

connector

commandFactory

opTimeout

connectionPoolSize

maxQueuedNoReplyOperations

resolveInetAddresses

serverOrderCount

NAMESPACE_LOCAL

Constructor Detail

XMemcachedClient

XMemcachedClient

XMemcachedClient

XMemcachedClient

XMemcachedClient

XMemcachedClient

XMemcachedClient

XMemcachedClient

XMemcachedClient

Method Detail

setMergeFactor

getTimeoutExceptionThreshold

setTimeoutExceptionThreshold

withNamespace

endWithNamespace

beginWithNamespace

getKeyProvider

setKeyProvider

getSessionLocator

getSessionComparator

getCommandFactory

getName

setName

getConnectTimeout

setConnectTimeout

setEnableHeartBeat

getOpTimeout

setOpTimeout

setHealSessionInterval

getHealSessionInterval

getAuthInfoMap

setAuthInfoMap

getAuthInfoStringMap

getConnector

setOptimizeMergeBuffer

isShutdown

sendCommand

newSocketAddress

addServer

addServer

addServer

addServer

addServer

addOneServerWithWeight

getServersDescription

setServerWeight

removeServer

removeServer

connect

newConnector

setOptimizeGet

setBufferAllocator

get

get

get

get

gets

gets

gets

gets

get

get