org.csource.fastdht

类 FastDHTClient

java.lang.Object

org.csource.fastdht.FastDHTClient

public class FastDHTClient
extends Object

FastDHT client

版本:

Version 1.05

作者:

Happy Fish / YuQing

字段概要

字段

限定符和类型	字段和说明
protected ServerGroup	serverGroup
protected byte	status

构造器概要

构造器

构造器和说明
FastDHTClient(boolean bMultiThread)
FastDHTClient(ServerGroup serverGroup)

方法概要

限定符和类型	方法和说明
int	batchDelete(ObjectInfo objInfo, String[] keys, Map failKeys) delete multi keys
Hashtable	batchGet(ObjectInfo objInfo, String[] keys, Map failKeys) get multi keys
Hashtable	batchGet(ObjectInfo objInfo, String[] keys, Map failKeys, int expires) get multi keys
int	batchSet(ObjectInfo objInfo, Map keyValues, Map failKeys) set values of multi keys
int	batchSet(ObjectInfo objInfo, Map keyValues, Map failKeys, int expires) set values of multi keys
void	close()
int	delete(KeyInfo keyInfo) delete key
String	get(KeyInfo keyInfo) retrieve value of key
String	get(KeyInfo keyInfo, int expires) retrieve value of key
byte[]	getBytes(KeyInfo keyInfo) retrieve value of key
byte[]	getBytes(KeyInfo keyInfo, int expires) retrieve value of key
byte	getErrorCode()
String[]	getSubKeys(ObjectInfo objInfo) get object's sub keys
Long	inc(KeyInfo keyInfo, int increment)
Long	inc(KeyInfo keyInfo, int increment, int expires) retrieve value of key
int	set(KeyInfo keyInfo, byte[] value) set value of key
int	set(KeyInfo keyInfo, byte[] value, int expires) set value of key
int	set(KeyInfo keyInfo, String value) set value of key
int	set(KeyInfo keyInfo, String value, int expires) set value of key
Hashtable	stat(int server_index) get stat hashtable

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

serverGroup

protected ServerGroup serverGroup

status

protected byte status

构造器详细资料

FastDHTClient

public FastDHTClient(ServerGroup serverGroup)

参数:

serverGroup - group info

FastDHTClient

public FastDHTClient(boolean bMultiThread)

参数:

bMultiThread - if use in multi-thread

方法详细资料

close

public void close()

getErrorCode

public byte getErrorCode()

返回:

the error code of last call

set

public int set(KeyInfo keyInfo,
               String value)
        throws UnsupportedEncodingException,
               MyException

set value of key

参数:

keyInfo - the key to set

value - value of the key

返回:

0 for success, != 0(errno) for fail

抛出:

UnsupportedEncodingException

MyException

set

public int set(KeyInfo keyInfo,
               byte[] value)
        throws UnsupportedEncodingException,
               MyException

set value of key

参数:

keyInfo - the key to set

value - value of the key

返回:

0 for success, != 0(errno) for fail

抛出:

UnsupportedEncodingException

MyException

set

public int set(KeyInfo keyInfo,
               String value,
               int expires)
        throws UnsupportedEncodingException,
               MyException

set value of key

参数:

keyInfo - the key to set

value - value of the key

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NEVER for never expired

返回:

0 for success, != 0(errno) for fail

抛出:

UnsupportedEncodingException

MyException

set

public int set(KeyInfo keyInfo,
               byte[] value,
               int expires)
        throws UnsupportedEncodingException,
               MyException

set value of key

参数:

keyInfo - the key to set

value - value of the key

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NEVER for never expired

返回:

0 for success, != 0(errno) for fail

抛出:

UnsupportedEncodingException

MyException

delete

public int delete(KeyInfo keyInfo)
           throws MyException

delete key

参数:

keyInfo - the key to delete

返回:

0 for success, != 0(status) for fail

抛出:

MyException

get

public String get(KeyInfo keyInfo)
           throws UnsupportedEncodingException,
                  MyException

retrieve value of key

参数:

keyInfo - the key to get

返回:

none null for success, null for fail

抛出:

UnsupportedEncodingException

MyException

get

public String get(KeyInfo keyInfo,
                  int expires)
           throws UnsupportedEncodingException,
                  MyException

retrieve value of key

参数:

keyInfo - the key to get

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NONE for not change the expired time

返回:

none null for success, null for fail

抛出:

UnsupportedEncodingException

MyException

getBytes

public byte[] getBytes(KeyInfo keyInfo)
                throws UnsupportedEncodingException,
                       MyException

retrieve value of key

参数:

keyInfo - the key to get

返回:

none null for success, null for fail

抛出:

UnsupportedEncodingException

MyException

getBytes

public byte[] getBytes(KeyInfo keyInfo,
                       int expires)
                throws MyException

retrieve value of key

参数:

keyInfo - the key to get

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NONE for not change the expired time

返回:

none null for success, null for fail

抛出:

MyException

inc

public Long inc(KeyInfo keyInfo,
                int increment)
         throws MyException

抛出:

MyException

inc

public Long inc(KeyInfo keyInfo,
                int increment,
                int expires)
         throws MyException

retrieve value of key

参数:

keyInfo - the key to get

increment - increment value

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NEVER for never expired

返回:

none null for success, null for fail

抛出:

MyException

batchSet

public int batchSet(ObjectInfo objInfo,
                    Map keyValues,
                    Map failKeys)
             throws MyException

set values of multi keys

参数:

objInfo - object info, including namespace and object id

keyValues - key value pair, key and value's type is String

failKeys - fail key, key 's type is String and value's type is Integer

返回:

success set key count, lg 0 for all keys fail

抛出:

MyException - if an error occurred

batchSet

public int batchSet(ObjectInfo objInfo,
                    Map keyValues,
                    Map failKeys,
                    int expires)
             throws MyException

set values of multi keys

参数:

objInfo - object info, including namespace and object id

keyValues - key value pair, key and value's type is String

failKeys - fail key, key 's type is String and value's type is Integer

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NEVER for never expired

返回:

success set key count, lg 0 for all keys fail

抛出:

MyException - if an error occurred

batchDelete

public int batchDelete(ObjectInfo objInfo,
                       String[] keys,
                       Map failKeys)
                throws MyException

delete multi keys

参数:

objInfo - object info, including namespace and object id

keys - key array

failKeys - fail key, key 's type is String and value's type is Integer

返回:

success set key count, lg 0 for all keys fail

抛出:

MyException - if an error occurred

batchGet

public Hashtable batchGet(ObjectInfo objInfo,
                          String[] keys,
                          Map failKeys)
                   throws MyException

get multi keys

参数:

objInfo - object info, including namespace and object id

keys - key array

failKeys - fail key, key 's type is String and value's type is Integer

返回:

none null for success, null for all keys fail

抛出:

MyException - if an error occurred

batchGet

public Hashtable batchGet(ObjectInfo objInfo,
                          String[] keys,
                          Map failKeys,
                          int expires)
                   throws MyException

get multi keys

参数:

objInfo - object info, including namespace and object id

keys - key array

failKeys - fail key, key 's type is String and value's type is Integer

expires - expire timestamp, ProtoCommon.FDHT_EXPIRES_NONE for not change the expired time

返回:

none null for success, null for all keys fail

抛出:

MyException - if an error occurred

stat

public Hashtable stat(int server_index)
               throws MyException

get stat hashtable

参数:

server_index - the server index

返回:

stat Hashtable for success, null for fail

抛出:

MyException - if an error occurred

getSubKeys

public String[] getSubKeys(ObjectInfo objInfo)
                    throws UnsupportedEncodingException,
                           MyException

get object's sub keys

参数:

objInfo - object info, including namespace and object id

返回:

string array for success, null for fail

抛出:

UnsupportedEncodingException - if an error occurred

MyException - if an error occurred