bee.cloud.cache

接口 Cache

所有已知实现类:

NullCache, RedisCache

public interface Cache

功能说明：缓存操作接口

1) String(字符串)操作

可以对单个字符串进行存、取、删除、设置过期日期操作。

2) Hash(哈希表)操作

作者:

chenxiang 2014-10-7

嵌套类概要

嵌套类

限定符和类型	接口和说明
static interface	Cache.Stack 列表队列

方法概要

限定符和类型	方法和说明
void	del(String... keys) 删除给定的一个或多个 key，不存在的 key 会被忽略。
boolean	exists(String key) 检查给定 key 是否存在。
void	expire(String key, Date date) 为给定 key 设置生存时间，当 key 过期时(生存时间到了指定的日期后 )，它会被自动删除。
void	expire(String key, int seconds) 为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。
String	get(String key) 返回 key 所关联的字符串值。
Map<String,String>	gets(Set<String> keys) 返回 key 所关联的字符串值。
Cache.Stack	getStack(String key) 获取一个堆栈
void	hdel(String key, String... fields) 删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。
boolean	hexists(String key, String field) 查看哈希表 key 中，给定域 field 是否存在。
String	hget(String key, String field) 返回哈希表 key 中给定域 field 的值。
Map<String,String>	hgetAll(String key) 返回哈希表 key 中，所有的域field和值。
Map<String,String>	hgets(String key, String... field) 返回哈希表 key 中给定域 field 的值。
long	hincrBy(String key, String field) 为哈希表 key 中的域 field 的值加1 。
long	hincrBy(String key, String field, long value) 为哈希表 key 中的域 field 的值加上增量 increment 。
Set<String>	hkeys(String key) 返回哈希表 key 中的所有域field。
long	hlen(String key) 返回哈希表 key 中域的数量。
void	hset(String key, Map<String,String> values) 将哈希表 key 中的域 field 的值设为 value 。
void	hset(String key, String field, String value) 将哈希表 key 中的域 field 的值设为 value 。
long	incr(String key) 将 key 中储存的数字值增一。
long	incr(String key, long increment) 将 key 所储存的值加上增量 increment 。
Set<String>	keys(String pattern) 查找所有符合给定模式 pattern 的 key 。
long	llen(String key) 返回key类型为list的数量
String	lpop(String key) 从key中从左边pop一个值
long	lpush(String key, String... val) 从左边push值到指定的key中
void	persist(String key) 为给定 key 撤消设置生存的时间
String	rpop(String key) 从key中从右边pop一个值
long	rpush(String key, String... val) 从右边push值到指定的key中
void	set(String key, String value) 将字符串值 value 关联到 key 。
void	set(String key, String value, int seconds) 将值 value 关联到 key ，并将 key 的生存时间设为 seconds (以秒为单位)。

方法详细资料

get

String get(String key)

返回 key 所关联的字符串值。 如果 key 不存在那么返回特殊值 null 。

参数:

key - -

返回:

当 key 不存在时，返回 null ，否则，返回 key 的值。

gets

Map<String,String> gets(Set<String> keys)

返回 key 所关联的字符串值。 如果 key 不存在那么返回特殊值 null 。

参数:

keys - -

返回:

当 key 不存在时，返回 null ，否则，返回 key 的值。

keys

Set<String> keys(String pattern)

查找所有符合给定模式 pattern 的 key 。
KEYS * 匹配数据库中所有 key 。
KEYS h?llo 匹配 hello ， hallo 和 hxllo 等。
KEYS h*llo 匹配 hllo 和 heeeeello 等。
KEYS h[ae]llo 匹配 hello 和 hallo ，但不匹配 hillo 。
特殊符号用 \ 隔开
注意 KEYS 的速度非常快，但在一个大的数据库中使用它仍然可能造成性能问题。

参数:

pattern - -

返回:

符合给定模式的 key 列表。

set

void set(String key,
         String value)

将字符串值 value 关联到 key 。
如果 key 已经持有其他值， SET 就覆写旧值，无视类型。

参数:

key - -

value - -

set

void set(String key,
         String value,
         int seconds)

将值 value 关联到 key ，并将 key 的生存时间设为 seconds (以秒为单位)。
如果 key 已经存在， 将覆写旧值。

参数:

key - -

value - -

seconds - -生存时间，单位（秒）

del

void del(String... keys)

删除给定的一个或多个 key，不存在的 key 会被忽略。

时间复杂度：

O(N)， N 为被删除的 key 的数量。
删除单个字符串类型的 key ，时间复杂度为O(1)。
删除单个列表、集合、有序集合或哈希表类型的 key ，时间复杂度为O(M)， M 为以上数据结构内的元素数量。

参数:

keys - -

exists

boolean exists(String key)

检查给定 key 是否存在。

参数:

key - -

返回:

若 key 存在，返回 true ，否则返回 false 。

expire

void expire(String key,
            int seconds)

为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。

参数:

key - -

seconds - -生存时间，单位（秒）

expire

void expire(String key,
            Date date)

为给定 key 设置生存时间，当 key 过期时(生存时间到了指定的日期后 )，它会被自动删除。

参数:

key - -

date - -生成到期日期

persist

void persist(String key)

为给定 key 撤消设置生存的时间

参数:

key - -

incr

long incr(String key)

将 key 中储存的数字值增一。
如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCR 操作。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。

参数:

key - -

返回:

执行 INCR 命令之后 key 的值。

incr

long incr(String key,
          long increment)

将 key 所储存的值加上增量 increment 。
如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCRBY 命令。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。

参数:

key - -

increment - -

返回:

加上 increment 之后， key 的值。

hkeys

Set<String> hkeys(String key)

返回哈希表 key 中的所有域field。

参数:

key - -

返回:

一个包含哈希表中所有域field的表。
当 key 不存在时，返回一个空表。

hexists

boolean hexists(String key,
                String field)

查看哈希表 key 中，给定域 field 是否存在。

参数:

key - -

field - -

返回:

如果哈希表含有给定域，返回 true 。
如果哈希表不含有给定域，或 key 不存在，返回 false 。

hgetAll

Map<String,String> hgetAll(String key)

返回哈希表 key 中，所有的域field和值。

参数:

key - -

返回:

以列表形式返回哈希表的域和域的值。
若 key 不存在，返回空Map。

hget

String hget(String key,
            String field)

返回哈希表 key 中给定域 field 的值。

参数:

key - -

field - -

返回:

给定域的值。 当给定域不存在或是给定 key 不存在时，返回 nil 。

hgets

Map<String,String> hgets(String key,
                         String... field)

返回哈希表 key 中给定域 field 的值。

参数:

key - -

field - -

返回:

给定域的值集Map。 当给定域不存在或是给定 key 不存在时，返回 nil 。

hset

void hset(String key,
          Map<String,String> values)

将哈希表 key 中的域 field 的值设为 value 。
如果 key 不存在，一个新的哈希表被创建并进行 HSET 操作。
如果域 field 已经存在于哈希表中，旧值将被覆盖。

参数:

key - -

values - -

hset

void hset(String key,
          String field,
          String value)

将哈希表 key 中的域 field 的值设为 value 。
如果 key 不存在，一个新的哈希表被创建并进行 HSET 操作。
如果域 field 已经存在于哈希表中，旧值将被覆盖。

参数:

key - -

field - -

value - -

hdel

void hdel(String key,
          String... fields)

删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。

参数:

key - -

fields - -

hincrBy

long hincrBy(String key,
             String field,
             long value)

为哈希表 key 中的域 field 的值加上增量 increment 。
增量也可以为负数，相当于对给定域进行减法操作。
如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。
对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。
本操作的值被限制在 64 位(bit)有符号数字表示之内。

参数:

key - -

field - -

value - -

返回:

执行 HINCRBY 命令之后，哈希表 key 中域 field 的值。

hincrBy

long hincrBy(String key,
             String field)

为哈希表 key 中的域 field 的值加1 。
如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。
对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。

参数:

key - -

field - -

返回:

执行 HINCRBY 命令之后，哈希表 key 中域 field 的值。

hlen

long hlen(String key)

返回哈希表 key 中域的数量。

参数:

key - -

返回:

哈希表中域的数量。
当 key 不存在时，返回 0 。

getStack

Cache.Stack getStack(String key)

获取一个堆栈

参数:

key - -

返回:

-

llen

long llen(String key)

返回key类型为list的数量

参数:

key - -

返回:

list中的数量

lpop

String lpop(String key)

从key中从左边pop一个值

参数:

key - -

返回:

-

lpush

long lpush(String key,
           String... val)

从左边push值到指定的key中

参数:

key - -

val - -

返回:

-

rpop

String rpop(String key)

从key中从右边pop一个值

参数:

key - -

返回:

-

rpush

long rpush(String key,
           String... val)

从右边push值到指定的key中

参数:

key - -

val - -

返回:

-