MemcachedClientBuilder (xmemcached 2.0.0 API)

所有已知实现类:

XMemcachedClientBuilder
```
public interface MemcachedClientBuilder
```
Builder pattern.Configure XmemcachedClient's options,then build it

作者:

dennis

方法概要

方法
限定符和类型	方法和说明
`void`	`addAuthInfo(InetSocketAddress address, AuthInfo authInfo)` Add auth info for memcached server
`void`	`addStateListener(MemcachedClientStateListener stateListener)` Add a state listener
`MemcachedClient`	`build()` Build MemcachedClient by current options.
`Map<InetSocketAddress,AuthInfo>`	`getAuthInfoMap()` return current all auth info
`BufferAllocator`	`getBufferAllocator()`
`CommandFactory`	`getCommandFactory()` get xmemcached's command factory
`Configuration`	`getConfiguration()` Return the default networking's configuration,you can change them.
`long`	`getConnectTimeout()` Returns connect timeout in milliseconds
`String`	`getName()` Return the cache instance name
`long`	`getOpTimeout()` Returns the default operation timeout in milliseconds.
`MemcachedSessionLocator`	`getSessionLocator()`
`Map<SocketOption,Object>`	`getSocketOptions()` Get all tcp socket options
`Transcoder`	`getTranscoder()` Set xmemcached's transcoder,it is used for seriailizing
`boolean`	`isFailureMode()` Returns if client is in failure mode.
`void`	`removeAuthInfo(InetSocketAddress address)` Remove auth info for memcached server
`void`	`removeStateListener(MemcachedClientStateListener stateListener)` Remove a state listener
`void`	`setAuthInfoMap(Map<InetSocketAddress,AuthInfo> map)` Configure auth info
`void`	`setBufferAllocator(BufferAllocator bufferAllocator)` Set nio ByteBuffer's allocator.Use SimpleBufferAllocator by default.You can choose CachedBufferAllocator.
`void`	`setCommandFactory(CommandFactory commandFactory)` set xmemcached's command factory.Default is TextCommandFactory,which implements memcached text protocol.
`void`	`setConfiguration(Configuration configuration)` Set the XmemcachedClient's networking configuration(reuseAddr,receiveBufferSize,tcpDelay etc.)
`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 connect timeout in milliseconds
`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`	`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`	`setMaxQueuedNoReplyOperations(int maxQueuedNoReplyOperations)` Set max queued noreply operations number
`void`	`setName(String name)` Set cache instance name
`void`	`setOpTimeout(long opTimeout)` Set default operation timeout.
`void`	`setSanitizeKeys(boolean sanitizeKeys)` Enables/disables sanitizing keys by URLEncoding.
`void`	`setSessionLocator(MemcachedSessionLocator sessionLocator)` Set the XmemcachedClient's session locator.Use ArrayMemcachedSessionLocator by default.If you want to choose consistent hash strategy,set it to KetamaMemcachedSessionLocator
`void`	`setSocketOption(SocketOption socketOption, Object value)` Set tcp socket option
`void`	`setStateListeners(List<MemcachedClientStateListener> stateListeners)` Set state listeners,replace current list
`void`	`setTranscoder(Transcoder transcoder)`

- 方法详细资料
  - getSessionLocator
```
MemcachedSessionLocator getSessionLocator()
```
    返回:
    net.rubyeye.xmemcached.MemcachedSessionLocator
  - setSessionLocator
```
void setSessionLocator(MemcachedSessionLocator sessionLocator)
```
    Set the XmemcachedClient's session locator.Use ArrayMemcachedSessionLocator by default.If you want to choose consistent hash strategy,set it to KetamaMemcachedSessionLocator
    
    参数:
    sessionLocator -
  - getBufferAllocator
```
BufferAllocator getBufferAllocator()
```
  - setBufferAllocator
```
void setBufferAllocator(BufferAllocator bufferAllocator)
```
    Set nio ByteBuffer's allocator.Use SimpleBufferAllocator by default.You can choose CachedBufferAllocator.
    
    参数:
    bufferAllocator -
  - getConfiguration
```
Configuration getConfiguration()
```
    Return the default networking's configuration,you can change them.
    
    返回:
  - setConfiguration
```
void setConfiguration(Configuration configuration)
```
    Set the XmemcachedClient's networking configuration(reuseAddr,receiveBufferSize,tcpDelay etc.)
    
    参数:
    configuration -
  - build
```
MemcachedClient build()
                      throws IOException
```
    Build MemcachedClient by current options.
    
    返回:
    
    抛出:
    
    IOException
  - setConnectionPoolSize
```
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. 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.
    
    参数:
    poolSize - pool size,default is 1
  - getTranscoder
```
Transcoder getTranscoder()
```
    Set xmemcached's transcoder,it is used for seriailizing
    
    返回:
  - setTranscoder
```
void setTranscoder(Transcoder transcoder)
```
  - getCommandFactory
```
CommandFactory getCommandFactory()
```
    get xmemcached's command factory
    
    返回:
  - addStateListener
```
void addStateListener(MemcachedClientStateListener stateListener)
```
    Add a state listener
    
    参数:
    stateListener -
  - removeStateListener
```
void removeStateListener(MemcachedClientStateListener stateListener)
```
    Remove a state listener
    
    参数:
    stateListener -
  - setStateListeners
```
void setStateListeners(List<MemcachedClientStateListener> stateListeners)
```
    Set state listeners,replace current list
    
    参数:
    stateListeners -
  - setCommandFactory
```
void setCommandFactory(CommandFactory commandFactory)
```
    set xmemcached's command factory.Default is TextCommandFactory,which implements memcached text protocol.
    
    参数:
    commandFactory -
  - setSocketOption
```
void setSocketOption(SocketOption socketOption,
                   Object value)
```
    Set tcp socket option
    
    参数:
    socketOption -
    value -
  - getSocketOptions
```
Map<SocketOption,Object> getSocketOptions()
```
    Get all tcp socket options
    
    返回:
  - setAuthInfoMap
```
void setAuthInfoMap(Map<InetSocketAddress,AuthInfo> map)
```
    Configure auth info
    
    参数:
    map - Auth info map,key is memcached server address,and value is the auth info for the key.
  - getAuthInfoMap
```
Map<InetSocketAddress,AuthInfo> getAuthInfoMap()
```
    return current all auth info
    
    返回:
    Auth info map,key is memcached server address,and value is the auth info for the key.
  - addAuthInfo
```
void addAuthInfo(InetSocketAddress address,
               AuthInfo authInfo)
```
    Add auth info for memcached server
    
    参数:
    address -
    authInfo -
  - removeAuthInfo
```
void removeAuthInfo(InetSocketAddress address)
```
    Remove auth info for memcached server
    
    参数:
    address -
  - getName
```
String getName()
```
    Return the cache instance name
    
    返回:
  - setName
```
void setName(String name)
```
    Set cache instance name
    
    参数:
    name -
  - setFailureMode
```
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. 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.
    
    参数:
    failureMode - true is to configure client in failure mode.
  - isFailureMode
```
boolean isFailureMode()
```
    Returns if client is in failure mode.
    
    返回:
  - getConnectTimeout
```
long getConnectTimeout()
```
    Returns connect timeout in milliseconds
    
    返回:
    connect timeout
  - setConnectTimeout
```
void setConnectTimeout(long connectTimeout)
```
    Set connect timeout in milliseconds
    
    参数:
    connectTimeout -
    另请参阅:
    MemcachedClient.DEFAULT_CONNECT_TIMEOUT
  - setSanitizeKeys
```
void setSanitizeKeys(boolean sanitizeKeys)
```
    Enables/disables sanitizing keys by URLEncoding.
    
    参数:
    sanitizeKey - if true, then URLEncode all keys
  - setKeyProvider
```
void setKeyProvider(KeyProvider keyProvider)
```
    Set a key provider for pre-processing keys before sending them to memcached.
    
    参数:
    keyProvider -
    从以下版本开始:
    
    1.3.8
  - setMaxQueuedNoReplyOperations
```
void setMaxQueuedNoReplyOperations(int maxQueuedNoReplyOperations)
```
    Set max queued noreply operations number
    
    参数:
    maxQueuedNoReplyOperations -
    从以下版本开始:
    
    1.3.8
    
    另请参阅:
    MemcachedClient.DEFAULT_MAX_QUEUED_NOPS
  - setHealSessionInterval
```
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. You can change that value by this method.
    
    参数:
    healConnectionInterval - MILLISECONDS
    从以下版本开始:
    
    1.3.9
  - setEnableHealSession
```
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.
    
    参数:
    enableHealSession -
    从以下版本开始:
    
    1.3.9
  - setOpTimeout
```
void setOpTimeout(long opTimeout)
```
    Set default operation timeout.
    
    参数:
    opTimeout - Operation timeout value in milliseconds.
    从以下版本开始:
    
    1.4.1
  - getOpTimeout
```
long getOpTimeout()
```
    Returns the default operation timeout in milliseconds.
    
    返回:
    从以下版本开始:
    
    1.4.1

接口 MemcachedClientBuilder

方法概要

方法详细资料

getSessionLocator

setSessionLocator

getBufferAllocator

setBufferAllocator

getConfiguration

setConfiguration

build

setConnectionPoolSize

getTranscoder

setTranscoder

getCommandFactory

addStateListener

removeStateListener

setStateListeners

setCommandFactory

setSocketOption

getSocketOptions

setAuthInfoMap

getAuthInfoMap

addAuthInfo

removeAuthInfo

getName

setName

setFailureMode

isFailureMode

getConnectTimeout

setConnectTimeout

setSanitizeKeys

setKeyProvider

setMaxQueuedNoReplyOperations

setHealSessionInterval

setEnableHealSession

setOpTimeout

getOpTimeout