简介
实现发布与订阅功能,类似于消息系统,相比于list实现的简单队列,可以做到生产一次消息,消费多次
发布的消息在Redis系统中不存储。因此,必须先执行订阅,再等待消息发布。 但是,相反的顺序则不支持。
命令说明
PUBLISH
PUBLISH channel message
时间复杂度: O(N+M),其中 N 是频道 channel 的订阅者数量,而 M 则是使用模式订阅(subscribed patterns)的客户端的数量
功能说明
将信息 message 发送到指定的频道 channel
返回值
接收到信息 message 的订阅者数量
示例
publish bad_channel "can any body hear me?"
SUBSCRIBE
SUBSCRIBE channel [channel …]
时间复杂度: O(N),其中 N 是订阅的频道的数量
功能说明
订阅给定的一个或多个频道的信息
返回值
接收到的信息(请参见下面的代码说明)
示例
# 1 - 6 行是执行 subscribe 之后的反馈信息
# 第 7 - 9 行才是接收到的第一条信息
# 第 10 - 12 行是第二条
redis> subscribe msg chat_room
Reading messages... (press Ctrl-C to quit)
1) "subscribe" # 返回值的类型:显示订阅成功
2) "msg" # 订阅的频道名字
3) (integer) 1 # 目前已订阅的频道数量
1) "subscribe"
2) "chat_room"
3) (integer) 2
1) "message" # 返回值的类型:信息
2) "msg" # 来源(从那个频道发送过来)
3) "hello moto" # 信息内容
1) "message"
2) "chat_room"
3) "testing...haha"
PSUBSCRIBE
PSUBSCRIBE pattern [pattern …]
时间复杂度: O(N), N 是订阅的模式的数量
功能说明
订阅一个或多个符合给定模式的频道。
每个模式以 * 作为匹配符,比如 it* 匹配所有以 it 开头的频道( it.news 、 it.blog 、 it.tweets 等等), news.* 匹配所有以 news. 开头的频道( news.it 、 news.global.today 等等),诸如此类
返回值
接收到的信息(请参见下面的代码说明)
示例
# 订阅 news.* 和 tweet.* 两个模式
# 第 1 - 6 行是执行 psubscribe 之后的反馈信息
# 第 7 - 10 才是接收到的第一条信息
# 第 11 - 14 是第二条
# 以此类推。。。
redis> psubscribe news.* tweet.*
Reading messages... (press Ctrl-C to quit)
1) "psubscribe" # 返回值的类型:显示订阅成功
2) "news.*" # 订阅的模式
3) (integer) 1 # 目前已订阅的模式的数量
1) "psubscribe"
2) "tweet.*"
3) (integer) 2
1) "pmessage" # 返回值的类型:信息
2) "news.*" # 信息匹配的模式
3) "news.it" # 信息本身的目标频道
4) "Google buy Motorola" # 信息的内容
1) "pmessage"
2) "tweet.*"
3) "tweet.huangz"
4) "hello"
1) "pmessage"
2) "tweet.*"
3) "tweet.joe"
4) "@huangz morning"
1) "pmessage"
2) "news.*"
3) "news.life"
4) "An apple a day, keep doctors away"
UNSUBSCRIBE
UNSUBSCRIBE [channel [channel …]]
时间复杂度: O(N), N 是客户端已订阅的频道的数量
功能说明
指示客户端退订给定的频道。
如果没有频道被指定,也即是,一个无参数的 UNSUBSCRIBE 调用被执行,那么客户端使用 SUBSCRIBE 命令订阅的所有频道都会被退订。在这种情况下,命令会返回一个信息,告知客户端所有被退订的频道
返回值
这个命令在不同的客户端中有不同的表现
PUNSUBSCRIBE
PUNSUBSCRIBE [pattern [pattern …]]
时间复杂度: O(N+M) ,其中 N 是客户端已订阅的模式的数量, M 则是系统中所有客户端订阅的模式的数量
功能说明
指示客户端退订所有给定模式。
如果没有模式被指定,也即是,一个无参数的 PUNSUBSCRIBE 调用被执行,那么客户端使用 PSUBSCRIBE pattern [pattern …] 命令订阅的所有模式都会被退订。在这种情况下,命令会返回一个信息,告知客户端所有被退订的模式
返回值
这个命令在不同的客户端中有不同的表现
PUBSUB
PUBSUB [argument [argument …]]
PUBSUB 是一个查看订阅与发布系统状态的内省命令, 它由数个不同格式的子命令组成, 以下将分别对这些子命令进行介绍。
PUBSUB CHANNELS [pattern]
时间复杂度
O(N) , N 为活跃频道的数量(对于长度较短的频道和模式来说,将进行模式匹配的复杂度视为常数)
功能说明
列出当前的活跃频道。
活跃频道指的是那些至少有一个订阅者的频道, 订阅模式的客户端不计算在内。
pattern 参数是可选的:
- 如果不给出 pattern 参数,那么列出订阅与发布系统中的所有活跃频道。
- 如果给出 pattern 参数,那么只列出和给定模式 pattern 相匹配的那些活跃频道
返回值
一个由活跃频道组成的列表
PUBSUB NUMSUB [channel-1 … channel-N]
时间复杂度
O(N) ,N 为给定频道的数量。
功能说明
返回给定频道的订阅者数量, 订阅模式的客户端不计算在内。
返回值
一个多条批量回复(Multi-bulk reply),回复中包含给定的频道,以及频道的订阅者数量。 格式为:频道 channel-1 , channel-1 的订阅者数量,频道 channel-2 , channel-2 的订阅者数量,诸如此类。
回复中频道的排列顺序和执行命令时给定频道的排列顺序一致。 不给定任何频道而直接调用这个命令也是可以的, 在这种情况下, 命令只返回一个空列表
PUBSUB NUMPAT
时间复杂度 O(1)
功能说明
返回订阅模式的数量。
注意, 这个命令返回的不是订阅模式的客户端的数量, 而是客户端订阅的所有模式的数量总和
返回值
一个整数回复