Skip to content

Latest commit

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

RedisUtil

介绍

 最全的Java操作Redis的工具类,封装了对Redis五种基本类型的各种操作,力求符合Redis的原生操作,使用StringRedisTemplate实现!

快速导航:
key命令操作 | String数据操作 | Hash数据操作 | List数据操作 | Set数据操作 | zSet数据操作

相关知识:
Redis基础知识补充 | Spring集成Redis | 在SpringBoot中使用

解惑

 很多人提出疑问“为什么没有操作Object的方法?”,请看这里介绍redistemplate和stringredistemplate

用法

一、keys相关命令

NO方法描述
1void delete(String key)key存在时删除key
2void delete(Collection keys)批量删除key
3byte[] dump(String key)序列化key,返回被序列化的值
4Boolean hasKey(String key)检查key是否存在
5Boolean expire(String key, long timeout, TimeUnit unit)设置过期时间
6Boolean expireAt(String key, Date date)设置过期时间
7Set keys(String pattern)查找所有符合给定模式(pattern)的key
8Boolean move(String key, int dbIndex)将当前数据库的key移动到给定的数据库db当中
9Boolean persist(String key)移除key的过期时间,key将持久保持
10Long getExpire(String key, TimeUnit unit)返回key的剩余的过期时间
11Long getExpire(String key)返回key的剩余的过期时间
12String randomKey()从当前数据库中随机返回一个key
13void rename(String oldKey, String newKey)修改key的名称
14Boolean renameIfAbsent(String oldKey, String newKey)仅当newkey不存在时,将oldKey改名为 newkey
15DataType type(String key)返回key所储存的值的类型

TimeUnit是时间单位,可选值有:
天:TimeUnit.DAYS、小时:TimeUnit.HOURS、分钟:TimeUnit.MINUTES、秒:TimeUnit.SECONDS、毫秒:TimeUnit.MILLISECONDS。


二、String数据类型操作

NO方法描述
1String get(String key)获取指定key的值
2String getRange(String key, long start, long end)返回key中字符串值的子字符
3String getAndSet(String key, String value)将key的值设为value,并返回key旧值
4Boolean getBit(String key, long offset)对key所储存的值,获取指定位置上的bit
5List multiGet(Collection keys)批量获取
添加相关
6void set(String key, String value)设置指定key的值
7boolean setBit(String key, long offset, boolean value)设置指定位置上的ASCII码
8void setEx(String key,String value,long timeout,TimeUnit unit)将值value关联到key,并设置key过期时间
9boolean setIfAbsent(String key, String value)只有在 key 不存在时设置 key 的值
10void setRange(String key, String value, long offset)用value覆写key的值,从偏移量offset开始
11void multiSet(Map<String,String> maps)批量添加
12boolean multiSetIfAbsent(Map<String,String> maps)批量添加,仅当所有key都不存在
其他方法
13Integer append(String key, String value)追加到末尾
14Long incrBy(String key, long increment)增加(自增长), 负数则为自减
15Double incrByFloat(String key, double increment)增加(自增长), 负数则为自减
16Long size(String key)获取字符串的长度

关于上面xxBit方法的使用:
例如字符'a'的ASCII码是97,转为二进制是'01100001',setBit方法就是把第offset位置上变成0或者1,true是1,false是0。


三、Hash相关的操作

NO方法描述
1Object hGet(String key, String field)获取存储在哈希表中指定字段的值
2Map hGetAll(String key)获取所有给定字段的值
3List hMultiGet(String key, Collection fields)获取所有给定字段的值
添加相关
4void hPut(String key, String hashKey, String value)添加字段
5void hPutAll(String key, Map maps)添加多个字段
6Boolean hPutIfAbsent(String key,String hashKey,String value)仅当hashKey不存在时才设置
其他方法
7Long hDelete(String key, Object... fields)删除一个或多个哈希表字段
8boolean hExists(String key, String field)查看哈希表key中指定的字段是否存在
9Long hIncrBy(String key, Object field, long increment)为哈希表key中指定字段的值增加increment
10Double hIncrByFloat(String key, Object field, double delta)为哈希表key中指定字段的值增加increment
11Set hKeys(String key)获取所有哈希表中的字段
12Long hSize(String key)获取哈希表中字段的数量
13List hValues(String key)获取哈希表中所有值
14Cursor hScan(String key, ScanOptions options)迭代哈希表中的键值对
引入序列化依赖 com.dyuproject.protostuff protostuff-core 1.0.8 com.dyuproject.protostuff protostuff-runtime 1.0.8
15getListCache(final String key, Class targetClass)获取缓存中的List,targetClass是序列化的类
16putListCacheWithExpireTime(String key, List objList, final long expireTime)把List放到缓存,expireTime是过期策略

四、List相关的操作

NO方法描述
1String lIndex(String key, long index)通过索引获取列表中的元素
2List lRange(String key, long start, long end)获取列表指定范围内的元素
添加相关
3Long lLeftPush(String key, String value)存储在list头部
4Long lLeftPushAll(String key, String... value)存储在list头部
5Long lLeftPushAll(String key, Collection value)存储在list头部
6Long lLeftPushIfPresent(String key, String value)当list存在的时候才加入
7lLeftPush(String key, String pivot, String value)如果pivot存在,再pivot前面添加
8Long lRightPush(String key, String value)存储在list尾部
9Long lRightPushAll(String key, String... value)存储在list尾部
10Long lRightPushAll(String key, Collection value)存储在list尾部
11Long lRightPushIfPresent(String key, String value)当list存在的时候才加入
12lRightPush(String key, String pivot, String value)在pivot元素的右边添加值
13void lSet(String key, long index, String value)通过索引设置列表元素的值
删除相关
14String lLeftPop(String key)移出并获取列表的第一个元素
15String lBLeftPop(String key,long timeout,TimeUnit unit)移出并获取第一个元素,没有则阻塞直到超时或有为止
16String lRightPop(String key)移除并获取列表最后一个元素
17String lBRightPop(String key,long timeout,TimeUnit unit)移出并获取最后个元素,没有则阻塞直到超时或有为止
18String lRightPopAndLeftPush(String sKey,String dKey)移除最后一个元素并加到另一个列表并返回
19String lBRightPopAndLeftPush(sKey,dKey,timeout,unit)移除最后个元素并加到另个列表并返回,阻塞超时或有
20Long lRemove(String key, long index, String value)删除集合中值等于value得元素
21void lTrim(String key, long start, long end)裁剪list
其他方法
22Long lLen(String key)获取列表长度

五、Set相关的操作

NO方法描述
1Set sMembers(String key)获取集合所有元素
2Long sSize(String key)获取集合大小
3Boolean sIsMember(String key, Object value)判断集合是否包含value
4String sRandomMember(String key)随机获取集合中的一个元素
5List sRandomMembers(String key, long count)随机获取集合count个元素
6Set sDistinctRandomMembers(String key, long count)随机获取count个元素并去除重复的
7Cursor sScan(String key, ScanOptions options)使用迭代器获取元素
8Set sIntersect(String key, String otherKey)获取两个集合的交集
9Set sIntersect(String key, Collection otherKeys)获取key集合与多个集合的交集
10Long sIntersectAndStore(String key, String oKey, String dKey)key集合与oKey的交集存储到dKey中
11Long sIntersectAndStore(String key,Collection oKeys,String dKey)key与多个集合的交集存储到dKey中
12Set sUnion(String key, String otherKeys)获取两个集合的并集
13Set sUnion(String key, Collection otherKeys)获取key集合与多个集合的并集
14Long sUnionAndStore(String key, String otherKey, String destKey)key集合与oKey的并集存储到dKey中
15Long sUnionAndStore(String key,Collection oKeys,String dKey)key与多个集合的并集存储到dKey中
16Set sDifference(String key, String otherKey)获取两个集合的差集
17Set sDifference(String key, Collection otherKeys)获取key集合与多个集合的差集
18Long sDifference(String key, String otherKey, String destKey)key与oKey集合的差集存储到dKey中
19Long sDifference(String key,Collection otherKeys,String dKey)key与多个集合的差集存储到dKey中
添加相关
20Long sAdd(String key, String... values)添加
删除相关
21Long sRemove(String key, Object... values)移除
22String sPop(String key)随机移除一个元素
23Boolean sMove(String key, String value, String destKey)将key集合中value移到destKey中

六、zset数据类型操作

NO方法描述
1Set zRange(String key, long start, long end)获取元素,小到大排序,s开始e结束位置
2Set<TypedTuple> zRangeWithScores(String key, long start, long end)获取集合元素, 并且把score值也获取
3Set zRangeByScore(String key, double min, double max)根据score范围查询元素,从小到大排序
4Set<TypedTuple> zRangeByScoreWithScores(key,double min,double max)根据score范围查询元素,并返回score
5Set zRangeByScoreWithScores(key,double min,max,long start,end)根据score查询元素,s开始e结束位置
6Set zReverseRange(String key, long start, long end)获取集合元素, 从大到小排序
7Set<TypedTuple> zReverseRangeWithScores(key, long start, long end)获取元素,从大到小排序,并返回score
8Set zReverseRangeByScore(String key, double min, double max)根据score范围查询元素,从大到小排序
9Set zReverseRangeByScoreWithScores(key,double min,double max)根据score查询,大到小排序返回score
10Set zReverseRangeByScore(key, double min, max, long start, end)根据score查询,大到小,s开始e结束
11Long zRank(String key, Object value)返回元素在集合的排名,score由小到大
12Long zReverseRank(String key, Object value)返回元素在集合的排名,score由大到小
13Long zCount(String key, double min, double max)根据score值范围获取集合元素的数量
14Long zSize(String key)获取集合大小
15Long zZCard(String key)获取集合大小
16Double zScore(String key, Object value)获取集合中value元素的score值
17Long zUnionAndStore(String key, String otherKey, String destKey)获取key和oKey的并集并存储在dKey中
18Long zUnionAndStore(String key,Collection otherKeys,String dKey)获取key和多个集合并集并存在dKey中
19Long zIntersectAndStore(String key, String otherKey, String destKey)获取key和oKey交集并存在destKey中
20Long zIntersectAndStore(String key,Collection oKeys,String dKey)获取key和多个集合交集并存在dKey中
21Cursor<TypedTuple> zScan(String key, ScanOptions options)使用迭代器获取
添加相关
22Boolean zAdd(String key, String value, double score)添加元素,zSet按score由小到大排列
23Long zAdd(String key, Set<TypedTuple> values)批量添加,TypedTuple使用见下面介绍
删除相关
24Long zRemove(String key, Object... values)移除
25Double zIncrementScore(String key, String value, double delta)增加元素的score值,并返回增加后的值
26Long zRemoveRange(String key, long start, long end)移除指定索引位置的成员
27Long zRemoveRangeByScore(String key, double min, double max)根据指定的score值的范围来移除成员

批量添加时TypedTuple的使用:
TypedTuple typedTuple = new DefaultTypedTuple(value,score)



知识补充

一、Redis知识补充

 Redis 可以存储键与5种不同数据结构类型之间的映射,这5种数据结构类型分别为:String(字符串)、List(列表)、Set(集合)、Hash(散列)和 zSet(有序集合)。

1.String(字符串)

结构存储的值:
可以是字符串、整数或者浮点数。

结构的读写能力:
对整个字符串或者字符串的其中一部分执行操作,对象和浮点数执行自增(increment)或者自减(decrement)。

2. List(列表)

结构存储的值:
一个链表,链表上的每个节点都包含了一个字符串。

结构的读写能力:
从链表的两端推入或者弹出元素,根据偏移量(offset)对链表进行修剪(trim),读取单个或者多个元素,根据值来查找或者移除元素。

3. Set(集合)

结构存储的值:
包含字符串的无序收集器(unOrderedCollection),并且被包含的每个字符串都是独一无二的、各不相同。

结构的读写能力:
添加、获取、移除单个元素,检查一个元素是否存在于某个集合中,计算交集、并集、差集,从集合里面随机获取元素。

4. Hash(散列)

结构存储的值:
包含键值对的无序散列表。

结构的读写能力:
添加、获取、移除单个键值对,获取所有键值对。

5. zSet(有序集合)

结构存储的值:
字符串成员(member)与浮点数分值(score)之间的有序映射,元素的排列顺序由分值(score)的大小决定。

结构的读写能力:
添加、获取、删除单个元素,根据分值(score)范围(range)或者成员来获取元素。


二、RedisTemplate和StringRedisTemplate

二者主要区别是他们使用的序列化类不一样,RedisTemplate使用的是JdkSerializationRedisSerializer, StringRedisTemplate使用的是StringRedisSerializer,两者的数据是不共通的。

1. RedisTemplate:

RedisTemplate使用的是JDK的序列化策略,向Redis存入数据会将数据先序列化成字节数组然后在存入Redis数据库, 这个时候打开Redis查看的时候,你会看到你的数据不是以可读的形式展现的,而是以字节数组显示,类似下面:\xAC\xED\x00\x05t\x05sr\x00

所以使用RedisTemplate可以把一个Java对象直接存储在Redis里面,但是存进去的数据是不易直观读的,不通用的, 建议不要直接存一个Object对象,可以变成Hash来存储,也可以转成json格式的数据来存储,在实际应用中也是很多都采用json格式来存储的。

2. StringRedisTemplate:

StringRedisTemplate默认采用的是String的序列化策略,保存的key和value都是采用此策略序列化保存的, StringRedisTemplate是继承RedisTemplate的,这种对redis的操方式更优雅,任何Redis连接工具,都可以读出直观的数据,便于数据的维护。


三、Redis与Spring的集成

1.集成配置

<beanid="poolConfig"class="redis.clients.jedis.JedisPoolConfig">
<propertyname="maxIdle"value="300" />
<propertyname="maxTotal"value="600" />
<propertyname="maxWaitMillis"value="1000" />
<propertyname="testOnBorrow"value="true" />
</bean>
<beanid="jedisConnectionFactory"class="org.springframework.data.redis.connection.jedis.JedisConnectionFactory">
<propertyname="hostName"value="127.0.0.1" />
<propertyname="password"value="" />
<propertyname="port"value="6379" />
<propertyname="poolConfig"ref="poolConfig" />
</bean>
<beanid="redisTemplate"class="org.springframework.data.redis.core.StringRedisTemplate">
<propertyname="connectionFactory"ref="jedisConnectionFactory" />
</bean>
<!-- RedisUtil注入RedisTemplate -->
<beanid="redisUtil"class="com.xxx.utils.RedisUtil">
<propertyname="redisTemplate"ref="redisTemplate" />
</bean>

2.使用RedisUtil工具类方法如下:

@AutowiredprivateRedisUtilredisUtil;

四、SpringBoot中如何使用

修改你的RedisUtil代码:

@ComponentpublicclassRedisUtil {
@AutowiredprivateStringRedisTemplateredisTemplate;
......
}

使用@Autowired自动注入redisTemplate。


推荐

EasyWeb管理系统模板 | 基于OAuth2.0的前后端分离开发平台


About

最全的Java操作Redis的工具类,使用StringRedisTemplate实现,封装了对Redis五种基本类型的各种操作!

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages