2 Star 2 Fork 71

lixiang6630 / RedisUtil

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0

RedisUtil

介绍

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

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

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

解惑

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

用法

一、keys相关命令

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

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


二、String数据类型操作

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

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


三、Hash相关的操作

NO 方法 描述
1 Object hGet(String key, String field) 获取存储在哈希表中指定字段的值
2 Map hGetAll(String key) 获取所有给定字段的值
3 List hMultiGet(String key, Collection fields) 获取所有给定字段的值
添加相关
4 void hPut(String key, String hashKey, String value) 添加字段
5 void hPutAll(String key, Map maps) 添加多个字段
6 Boolean hPutIfAbsent(String key,String hashKey,String value) 仅当hashKey不存在时才设置
其他方法
7 Long hDelete(String key, Object... fields) 删除一个或多个哈希表字段
8 boolean hExists(String key, String field) 查看哈希表key中指定的字段是否存在
9 Long hIncrBy(String key, Object field, long increment) 为哈希表key中指定字段的值增加increment
10 Double hIncrByFloat(String key, Object field, double delta) 为哈希表key中指定字段的值增加increment
11 Set hKeys(String key) 获取所有哈希表中的字段
12 Long hSize(String key) 获取哈希表中字段的数量
13 List hValues(String key) 获取哈希表中所有值
14 Cursor hScan(String key, ScanOptions options) 迭代哈希表中的键值对

四、List相关的操作

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

五、Set相关的操作

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

六、zset数据类型操作

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

<bean id="poolConfig" class="redis.clients.jedis.JedisPoolConfig">
	<property name="maxIdle" value="300" />
	<property name="maxTotal" value="600" />
	<property name="maxWaitMillis" value="1000" />
	<property name="testOnBorrow" value="true" />
</bean>

<bean id="jedisConnectionFactory" class="org.springframework.data.redis.connection.jedis.JedisConnectionFactory">
	<property name="hostName" value="127.0.0.1" />
	<property name="password" value="" />
	<property name="port" value="6379" />
	<property name="poolConfig" ref="poolConfig" />
</bean>

<bean id="redisTemplate" class="org.springframework.data.redis.core.StringRedisTemplate">
	<property name="connectionFactory" ref="jedisConnectionFactory" />
</bean>

<!-- RedisUtil注入RedisTemplate -->
<bean id="redisUtil" class="com.xxx.utils.RedisUtil">
	<property name="redisTemplate" ref="redisTemplate" />
</bean>

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

@Autowired
private RedisUtil redisUtil;

四、SpringBoot中如何使用

修改你的RedisUtil代码:

@Component
public class RedisUtil {
    @Autowired
    private StringRedisTemplate redisTemplate;

    ......
}

使用@Autowired自动注入redisTemplate。

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

最全的Java操作Redis的工具类,封装了对Redis五种基本类型的各种操作,使用StringRedisTemplate实现! 展开 收起
Java
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/lixiang6630/RedisUtil.git
git@gitee.com:lixiang6630/RedisUtil.git
lixiang6630
RedisUtil
RedisUtil
master

搜索帮助