redis-jedis研发学习整理

时间 2019-11-10

标签 redis jedis 研发学习整理栏目 Redis 繁體版

原文原文链接

Jedis简介

Jedis是Redis的java客户端。咱们能够在java编程中使用它来编写java代码访问Redis服务。html

程序里使用Redis

1、准备工做java

①安装redis:git

windows版本：https://github.com/mythz/redis-windowsgithub

下载完成后，右键解压到D:\redisredis

启动redis服务数据库

窗口保持开启，关闭时redis服务会自动关闭编程

②下载java开发包jediswindows

下载地址：http://www.oschina.net/p/jedis安全

pom.xml配置服务器

③java代码测试

运行结果：

调用Redis的相关方法

1.字符串数据类型（String）接口说明

字符串类型是Redis中最为基础的数据存储类型，它在Redis中是二进制安全的，这便意味着该类型能够接受任何格式的数据，如JPEG图像数据或Json对象描述信息等。在Redis中字符串类型的Value最多能够容纳的数据长度是512M。

#设定该Key持有指定的字符串Value，若是该Key已经存在，则覆盖其原有值。

--> void set(final String key, final String value)

#获取指定Key的Value，若是该Key不存在，返回null。

--> byte[] get(final String key)

#判断该键是否存在，存在返回1，不然返回0

--> boolean exists(final String key)

#删除指定的Key

--> long delete(final String... keys)

#重命名指定的Key, 若是参数中的两个Keys的命令相同，或者是源Key不存在，该命令都会返回相关的错误信息。若是newKey已经存在，则直接覆盖。

--> void rename(final String oldkey, final String newkey)

#若是新值不存在，则将参数中的原值修改成新值。其它条件和RENAME一致。

--> boolean renamenx(final String oldkey, final String newkey)

#设置某个key的过时时间（单位：秒）, 在超过该时间后，Key被自动的删除。若是该Key在超时以前被修改，与该键关联的超时将被移除。

--> boolean expire(final String key, final int seconds)

# EXPIREAT 的做用和 EXPIRE 相似，都用于为 key 设置生存时间。不一样在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。

--> boolean expireAt(final String key, final long unixTime)

#经过ttl命令查看一下指定Key的剩余存活时间(秒数)，0表示已通过期，-1表示永不过时。

--> long ttl(final String key)

#将当前数据库中的mysetkey键移入到ID为dbIndex的数据库中

--> boolean move(final String key, final int dbIndex)

#原子性的设置该Key为指定的Value，返回该Key的原有值，若是该Key以前并不存在，则返回null。

--> byte[] getSet(final String key, final String value)

#返回一组指定Keys的Values的列表。

--> List<byte[]> mget(final String... keys)

#若是指定的Key不存在，则设定该Key持有指定字符串Value，此时其效果等价于SET命令。相反，若是该Key已经存在，该命令将不作任何操做并返回。

--> boolean setnx(final String key, final String value)

--> boolean setex(final String key, final int seconds, final String value)

#该命令原子性的完成参数中全部key/value的设置操做，若是在这一批Keys中有任意一个Key已经存在了，那么该操做将所有回滚，即全部的修改都不会生效。

--> boolean msetnx(final String... keysvalues)

#将指定Key的Value原子性的递增1。若是该Key不存在，其初始值为0，在incr以后其值为1,返回递增后的值。

--> void incrBy(final String key, final long integer)

--> void incr(final String key)

#将指定Key的Value原子性的递减1。若是该Key不存在，其初始值为-1，在incr以后其值为1,返回递减后的值。

--> long decrBy(final String key, final long integer)

--> long decr(final String key)

#若是该Key已经存在，APPEND命令将参数Value的数据追加到已存在Value的末尾。若是该Key不存在，APPEND命令将会建立一个新的Key/Value。返回追加后的Value的长度。

--> long append(final String key, final String value)

2. 字符链表（List）数据类型接口说明

在Redis中，List类型是按照插入顺序排序的字符串链表。和数据结构中的普通链表同样，咱们能够在其头部(left)和尾部(right)添加新的元素。在插入时，若是该键并不存在，Redis将为该键建立一个新的链表。与此相反，若是链表中全部的元素均被移除，那么该键也将会被从数据库中删除。List中能够包含的最大元素数量是4,294,967,295(42亿左右)。

#在指定Key所关联的List Value的尾部插入参数中给出的全部Values。若是该Key不存在，该命令将在插入以前建立一个与该Key关联的空链表，以后再将数据从链表的尾部插入。若是该键的Value不是链表类型，该命令将返回相关的错误信息。

--> void rpush(final String key, final String... string)

#在指定Key所关联的List Value的头部插入参数中给出的全部Values。若是该Key不存在，该命令将在插入以前建立一个与该Key关联的空链表，以后再将数据从链表的头部插入。若是该键的Value不是链表类型，该命令将返回相关的错误信息。

--> void lpush(final String key, final String... string)

#返回指定Key关联的链表中元素的数量，若是该Key不存在，则返回0。若是与该Key关联的Value的类型不是链表，则返回相关的错误信息。

--> long llen(final String key)

#返回指定范围内元素的列表。该命令的参数start和end都是0-based。即0表示链表头部(leftmost)的第一个元素。其中start的值也能够为负值，-1将表示链表中的最后一个元素，即尾部元素，-2表示倒数第二个并以此类推。该命令在获取元素时，start和end位置上的元素也会被取出。若是start的值大于链表中元素的数量，空链表将会被返回。若是end的值大于元素的数量，该命令则获取从start(包括start)开始，链表中剩余的全部元素。

--> List<byte[]> lrange(final String key, final long start, final long end)

#该命令将仅保留指定范围内的元素，从而保证连接中的元素数量相对恒定。start和stop参数都是0-based，0表示头部元素。和其余命令同样，start和stop也能够为负值，-1表示尾部元素。若是start大于链表的尾部，或start大于stop，该命令不错报错，而是返回一个空的链表，与此同时该Key也将被删除。若是stop大于元素的数量，则保留从start开始剩余的全部元素。

--> void ltrim(final String key, final long start, final long end)

#该命令将返回链表中指定位置(index)的元素，index是0-based，表示头部元素，若是index为-1，表示尾部元素。若是与该Key关联的不是链表，该命令将返回相关的错误信息。

--> byte[] lindex(final String key, final long index)

#设定链表中指定位置的值为新值，其中0表示第一个元素，即头部元素，-1表示尾部元素。若是索引值Index超出了链表中元素的数量范围，该命令将返回相关的错误信息。

--> void lset(final String key, final long index, final String value)

#在指定Key关联的链表中，删除前count个值等于value的元素。若是count大于0，从头向尾遍历并删除，若是count小于0，则从尾向头遍历并删除。若是count等于0，则删除链表中全部等于value的元素。若是指定的Key不存在，则直接返回0,返回被删除的元素数量。

--> long lrem(final String key, long count, final String value)

#返回并弹出指定Key关联的链表中的第一个元素，即头部元素。若是该Key不存，返回null。

--> byte[] lpop(final String key)

#返回并弹出指定Key关联的链表中的最后一个元素，即尾部元素。若是该Key不存，返回nil。

--> byte[] rpop(final String key)

#原子性的从与srckey键关联的链表尾部弹出一个元素，同时再将弹出的元素插入到与dstkey键关联的链表的头部。若是srckey键不存在，该命令将返回null，同时再也不作任何其它的操做了。若是srckey和dstkey是同一个键，则至关于原子性的将其关联链表中的尾部元素移到该链表的头部。

--> byte[] rpoplpush(final String srckey, final String dstkey)

3. Hashes数据类型接口说明

Redis中的Hashes类型能够当作具备String Key和String Value的map容器。因此该类型很是适合于存储值对象的信息。如Username、Password和Age等。若是Hash中包含不多的字段，那么该类型的数据也将仅占用不多的磁盘空间。每个Hash能够存储4,294,967,295个键值对。

#为指定的Key设定Field/Value对，若是Key不存在，该命令将建立新Key以参数中的Field/Value对，若是参数中的Field在该Key中已经存在，则用新值覆盖其原有值。

--> boolean hset(final String key, final String field, final String value)

#返回参数中Field的关联值，若是参数中的Key或Field不存，返回null。

--> void hget(final String key, final String field)

#只有当参数中的Key或Field不存在的状况下，为指定的Key设定Field/Value对，不然该命令不会进行任何操做。

--> void hsetnx(final String key, final String field, final String value)

#逐对依次设置参数中给出的Field/Value对。若是其中某个Field已经存在，则用新值覆盖原有值。若是Key不存在，则建立新Key，同时设定参数中的Field/Value。

--> void hmset(final String key, final Map<String, String> hash)

#获取和参数中指定Fields关联的一组Values。若是请求的Field不存在，其值返回null。若是Key不存在，该命令将其视为空Hash，所以返回一组null。

--> byte[] hmget(final String key, final String... fields)

#增长指定Key中指定Field关联的Value的值。若是Key或Field不存在，该命令将会建立一个新Key或新Field，并将其关联的Value初始化为0，以后再指定数字增长的操做。返回运算后的值

--> long hincrBy(final String key, final String field, final long value)

#判断指定Key中的指定Field是否存在。

--> void hexists(final String key, final String field)

#从指定Key的Hashes Value中删除参数中指定的多个字段，若是不存在的字段将被忽略。若是Key不存在，则将其视为空Hashes，并返回0.返回实际删除的Field数量。

--> void hdel(final String key, final String... fields)

#获取该Key所包含的Field的数量。

--> void hlen(final String key)

#返回指定Key的全部Fields名。

--> List<byte[]> hkeys(final String key)

#返回指定Key的全部Values名。

--> List<byte[]> hvals(final String key)

#获取该键包含的全部Field/Value。其返回格式为一个Field、一个Value，并以此类推。

--> Map<byte[], byte[]> hgetAll(final String key)

4. 字符集合（Set）数据类型接口说明

在Redis中，将Set类型看做为没有排序的字符集合，和List类型同样，也能够在该类型的数据值上执行添加、删除或判断某一元素是否存在等操做。Set可包含的最大元素数量是4,294,967,295。

和List类型不一样的是，Set集合中不容许出现重复的元素，这一点和C++标准库中的set容器是彻底相同的。换句话说，若是屡次添加相同元素，Set中将仅保留该元素的一份拷贝。和List类型相比，Set类型在功能上还存在着一个很是重要的特性，即在服务器端完成多个Sets之间的聚合计算操做，如unions、intersections和differences。因为这些操做均在服务端完成，所以效率极高，并且也节省了大量的网络IO开销。

#若是在插入的过程用，参数中有的成员在Set中已经存在，该成员将被忽略，而其它成员仍将会被正常插入。若是执行该命令以前，该Key并不存在，该命令将会建立一个新的Set，此后再将参数中的成员陆续插入。若是该Key的Value不是Set类型，该命令将返回相关的错误信息。

--> boolean sadd(final String key, final String... members)

#获取与该Key关联的Set中全部的成员。

--> List<byte[]> smembers(final String key)

#从与Key关联的Set中删除参数中指定的成员，不存在的参数成员将被忽略，若是该Key并不存在，将视为空Set处理。

--> void srem(final String key, final String... members)

#随机的移除并返回Set中的某一成员。因为Set中元素的布局不受外部控制，所以没法像List那样肯定哪一个元素位于Set的头部或者尾部。

--> byte[] spop(final String key)

#原子性的将参数中的成员从srckey 键移入到dstkey键所关联的Set中。所以在某一时刻，该成员或者出如今source中，或者出如今dstkey中。若是该成员在srckey中并不存在，该命令将不会再执行任何操做并返回0，不然，该成员将从srckey移入到dstkey。若是此时该成员已经在dstkey中存在，那么该命令仅是将该成员从srckey中移出。若是和Key关联的Value不是Set，将返回相关的错误信息。

--> boolean smove(final String srckey, final String dstkey,final String member)

#获取Set中成员的数量。

--> long scard(final String key)

#判断参数中指定成员是否已经存在于与Key相关联的Set集合中。

--> boolean sismember(final String key, final String member)

#该命令将返回参数中全部Keys关联的Sets中成员的交集。所以若是参数中任何一个Key关联的Set为空，或某一Key不存在，那么该命令的结果将为空集。

--> List<byte[]> sinter(final String... keys)

#该命令和sinter 命令在功能上彻底相同，二者之间惟一的差异是sinter返回交集的结果成员，而该命令将交集成员存储在dstkey关联的Set中。若是dstkey键已经存在，该操做将覆盖它的成员。

--> void sinterstore(final String dstkey, final String... keys)

#该命令将返回参数中全部Keys关联的Sets中成员的并集。

--> List<byte[]> sunion(final String... keys)

#该命令和sunion命令在功能上彻底相同，二者之间惟一的差异是sunion返回并集的结果成员，而该命令将并集成员存储在dstkey关联的Set中。若是dstkey键已经存在，该操做将覆盖它的成员。

--> void sunionstore(final String dstkey, final String... keys)

#返回参数中第一个Key所关联的Set和其后全部Keys所关联的Sets中成员的差别。若是Key不存在，则视为空Set。

--> List<byte[]> sdiff(final String... keys)

#该命令和SDIFF命令在功能上彻底相同，二者之间惟一的差异是SDIFF返回差别的结果成员，而该命令将差别成员存储在dstkey关联的Set中。若是dstkey键已经存在，该操做将覆盖它的成员。

--> void sdiffstore(final String dstkey, final String... keys)

#和SPOP同样，随机的返回Set中的一个成员，不一样的是该命令并不会删除返回的成员。

--> void srandmember(final String key)

5.有序集合（Sorted-Sets）数据类型接口说明

Sorted-Sets和Sets类型极为类似，它们都是字符串的集合，都不容许重复的成员出如今一个Set中。它们之间的主要差异是Sorted-Sets中的每个成员都会有一个分数(score)与之关联，Redis正是经过分数来为集合中的成员进行从小到大的排序。然而须要额外指出的是，尽管Sorted-Sets中的成员必须是惟一的，可是分数(score)倒是能够重复的。

在Sorted-Set中添加、删除或更新一个成员都是很是快速的操做，其时间复杂度为集合中成员数量的对数。因为Sorted-Sets中的成员在集合中的位置是有序的，所以，即使是访问位于集合中部的成员也仍然是很是高效的。事实上，Redis所具备的这一特征在不少其它类型的数据库中是很难实现的，换句话说，在该点上要想达到和Redis一样的高效，在其它数据库中进行建模是很是困难的。

#在该命令中咱们能够指定多组score/member做为参数。若是在添加时参数中的某一成员已经存在，该命令将更新此成员的分数为新值，同时再将该成员基于新值从新排序。若是键不存在，该命令将为该键建立一个新的Sorted-Sets Value，并将score/member对插入其中。若是该键已经存在，可是与其关联的Value不是Sorted-Sets类型，相关的错误信息将被返回。

--> boolean zadd(final String key, final double score, final String member)

#该命令按顺序返回在参数start和stop指定范围内的成员，这里start和stop参数都是0-based，即0表示第一个成员，-1表示最后一个成员。若是start大于该Sorted-Set中的最大索引值，或start > stop，此时一个空集合将被返回。若是stop大于最大索引值，该命令将返回从start到集合的最后一个成员。若是命令中带有可选参数WITHSCORES选项，该命令在返回的结果中将包含每一个成员的分数值，如value1,score1,value2,score2...。　

--> List<byte[]> zrange(final String key, final long start, final long end)

#该命令将移除参数中指定的成员，其中不存在的成员将被忽略。若是与该Key关联的Value不是Sorted-Set，相应的错误信息将被返回。

--> boolean zrem(final String key, final String... members)

#该命令将为指定Key中的指定成员增长指定的分数。若是成员不存在，该命令将添加该成员并假设其初始分数为0，此后再将其分数加上increment。若是Key不存，该命令将建立该Key及其关联的Sorted-Sets，并包含参数指定的成员，其分数为increment参数。若是与该Key关联的不是Sorted-Sets类型，相关的错误信息将被返回。

--> Double zincrby(final String key, final double score,final String member)

# Sorted-Set中的成员都是按照分数从低到高的顺序存储，该命令将返回参数中指定成员的位置值，其中0表示第一个成员，它是Sorted-Set中分数最低的成员。

--> long zrank(final String key, final String member)

#该命令的功能和ZRANK基本相同，惟一的差异在于该命令获取的索引是从高到低排序后的位置，一样0表示第一个元素，即分数最高的成员。

--> long zrevrank(final String key, final String member)

#该命令的功能和ZRANGE基本相同，惟一的差异在于该命令是经过反向排序获取指定位置的成员，即从高到低的顺序。若是成员具备相同的分数，则按降序字典顺序排序。

--> List<byte[]> zrevrange(final String key, final long start, final long end)

#该命令将返回分数在min和max之间的全部成员，即知足表达式min <= score <= max的成员，其中返回的成员是按照其分数从低到高的顺序返回，若是成员具备相同的分数，则按成员的字典顺序返回。

--> List<byte[]> zrangeWithScores(final String key, final long start,final long end)

#该命令除了排序方式是基于从高到低的分数排序以外，其它功能和参数含义均与ZRANGEBYSCORE相同。

--> List<byte[]> zrevrangeWithScores(final String key, final long start,final long end)

#获取与该Key相关联的Sorted-Sets中包含的成员数量。

--> long zcard(final String key)

#获取指定Key的指定成员的分数。

--> Double zscore(final String key, final String member)

#获取指定Key的指定成员的分数。

--> void watch(final String... keys)

#给指定的Key的成员排序

--> Sort sort(final String key)

--> Sort sort(final String key, final SortingParams sortingParameters, final String dstkey)

--> Sort sort(final String key, final String dstkey)

#从左到右扫描返回对第一个非空 list 进行 lpop 操做并返回，好比 blpop list1 list2 list3 0 ,若是 list 不存在，list2,list3 都是非空则对 list2 作 lpop 并返回从 list2 中删除的元素。若是全部的 list 都是空或不存在，则会阻塞 timeout 秒，timeout 为 0 表示一直阻塞。当阻塞时，若是有client 对 key1...keyN 中的任意 key 进行 push 操做，则第一在这个 key 上被阻塞的 client 会当即返回。若是超时发生，则返回 nil。有点像 unix 的 select 或者 poll。

--> void blpop(final String[] args)

#与blpop相反

--> void brpop(final String[] args)

#该命令用于获取分数(score)在min和max之间的成员数量。

--> long zcount(final String key, final double min, final double max)

--> long zcount(final String key, final String min, final String max)

--> List<byte[]> zrangeByScore(final String key, final double min,final double max)

--> List<byte[]> zrangeByScore(final String key, final String min,final String max)

--> List<byte[]> zrangeByScore(final String key, final double min,final double max, final int offset, int count)

--> List<byte[]> zrangeByScoreWithScores(final String key, final double min,final double max)

--> List<byte[]> zrangeByScoreWithScores(final String key, final double min,

final double max, final int offset, final int count)

#删除集合中排名在给定区间的元素

--> void zremrangeByRank(final String key, final long start,final long end)

#删除集合中 score 在给定区间的元素

--> void zremrangeByScore(final String key, final double start,final double end)

--> void zremrangeByScore(final String key, final String start,final String end)