（转）pika详解(四) channel 通道

原文：https://blog.csdn.net/comprel/article/details/94662394

channel通道

通道是在connection建立后进行创建分配的，有利于connection重用

官方建议通过connection的channel() 方法进行创建

方法/参数：

add_callback(callback, replies, one_shot=True)

从 RabbitMQ broker 收到消息，在回复列表中，则调用回调函数，为replies列表添加回调函数

参数：
callback (callable)– 回调函数
replies (list) –callback 回调列表
one_shot (bool) – 只处理第一种类型的回调

add_on_cancel_callback(callback)

服务器发送basic_cancel时调用的回调函数

add_on_close_callback(callback)

通道关闭时调用的回调函数

add_on_flow_callback(callback)

远程服务器调用Channel.Flow时调用的回调函数

add_on_return_callback(callback)

basic_publish发送一条已被服务器拒绝并返回的消息时调用

basic_ack(delivery_tag=0, multiple=False)
参数：

delivery_tag (整数) – 服务器分配的传递标记

multiple 布尔值， 是否允许确认多条

basic_cancel(consumer_tag='', callback=None)

取消一个consumer， 不影响delivered 已经发送的消息，但这意味着rabbitmq broker不再向该consumer发送消息

consumer_tag 消费者的标识符

basic_consume(queue, on_message_callback, auto_ack=False, exclusive=False, consumer_tag=None, arguments=None, callback=None)
参数：
queue (str) – 队列名称
on_message_callback (callable) –回调函数， 回调的定义on_message_callback(channel, method, properties, body)
auto_ack (bool)–是否自动确认， 默认不自动确认消息
exclusive (bool)– 排他队列， 是否允许在队列中允许还有其他的consumer消费者
consumer_tag (str)– consumer的标志符
arguments (dict) – 消费者的自定义键/值对参数
callback (callable)– callback(pika.frame.Method) for method Basic.ConsumeOk.

basic_get(queue, callback, auto_ack=False)

获取单条消息

参数：
queue (str)– 队列名称
callback (callable)–回调函数， 回调定义callback(channel, method, properties, body),
auto_ack (bool)– 自动消息确认

basic_nack(delivery_tag=None, multiple=False, requeue=True)

允许客户端拒绝一个或多个传入消息。它可用于中断和取消大量传入消息，或将无法处理的消息返回到其原始队列

参数：
delivery-tag (integer) – int/long 服务器分配的 delivery id
multiple (bool) –是否允许多条
requeue (bool) – 如果requeue为true，服务器将尝试重新排队该消息。如果requeue为false或重新排队尝试失败，则丢弃或删除消息

basic_publish(exchange, routing_key, body, properties=None, mandatory=False)

发送消息

参数：

exchange (str)– 交换机名称
routing_key (str) – 路由键， 与交换机类型有关， topic 可以使用匹配规则， direct 则需要指定准确的路由键， 否则消息会被丢弃，或者返回给consumer， fanout则可以使用空字符""， 广播到交换机下的队列
body (bytes) – 消息内容
properties (pika.spec.BasicProperties) – Basic.properties 消息属性
mandatory (bool) – 强制性标志， 设置broker对于没有投递成功消息的处理机制：

如果exchange根据自身类型和消息routingKey无法找到一个合适的queue存储消息，
那么broker会调用basic.return方法将消息返还给生产者;当mandatory设置为false时，
出现上述情况broker会直接将消息丢弃

basic_qos(prefetch_size=0, prefetch_count=0, global_qos=False, callback=None)

参数：

prefetch_size - 该字段指定预取窗口大小。如果服务器的大小等于或小于可用的预取大小（并且也属于其他预取限制），则它将提前发送消息。可以设置为零，意味着“没有特定限制”，尽管其他预取限制可能仍然适用。启用no-ack选项的使用者将忽略prefetch-size。

prefetch_count- 根据整个消息指定预取窗口。该字段可以与预取大小字段结合使用; 如果预取窗口（以及通道和连接级别的窗口）都允许，则只会提前发送消息。启用no-ack选项的使用者将忽略prefetch-count。

global_qos - QoS是否适用于频道上的所有消费者

callback（callable） - 调用Basic.QosOk响应的回调

basic_reject(delivery_tag, requeue=True)

拒绝传入的消息。此方法允许客户端拒绝消息。它可用于中断和取消大量传入消息，或将无法处理的消息返回到其原始队列参数：
delivery-tag (integer)– 分配的tag
requeue (bool)–如果requeue为true，服务器将尝试重新排队该消息。如果requeue为false或重新排队尝试失败，则丢弃或删除消息

basic_recover(requeue=False, callback=None)

要求服务器重新传送指定通道上的所有未确认消息，可以重新传递零个或多个消息

close(reply_code=0, reply_text='Normal shutdown')

关闭
1
confirm_delivery(ack_nack_callback, callback=None)
开启通道 中的确认模式， 当consumer接收或者拒绝消息的时候会调用
1
consumer_tags

返回当前活动使用者列表的属性方法

exchange_bind(destination, source, routing_key='', arguments=None, callback=None)

交换机绑定， 将一个交换机绑定到另外一个交换机

参数：

`destination`（str） - 要绑定的目标交换
`source（str）` - 要绑定的源交换
`routing_key`（str） - 要绑定的路由键
`arguments`（dict） - 绑定的自定义键/值对参数
`callback`（callable） - 方法Exchange.BindOk的回调（pika.frame.Method）
1
2
3
4
5
6
7
8
9
exchange_declare(exchange, exchange_type='direct', passive=False, durable=False, auto_delete=False, internal=False, arguments=None, callback=None)
声明交换机

参数：
exchange(str) – 交换机名称
exchange_type (str) – 交换机类型， 一般使用topic(主题交换机)， direct， fanout(广播交换机)
passive (bool) – 执行检察或者只是检察是否存在， 默认为false， 即是，如果不存在则会创建交换机
durable (bool) – 是否持久化，决定了在rabbitmq重启后该交换机是否存在
auto_delete (bool) –自动删除
internal (bool)– 内部，只能由其他exchanges进行发布
arguments (dict)– 交换的自定义键/值对参数
callback (callable)– 方法Exchange.DeclareOk的回调（pika.frame.Method）

exchange_delete(exchange=None, if_unused=False, callback=None)

删除交换机

参数：
exchange (str) – 交换机删除
if_unused (bool) – 在没有使用时删除
callback (callable)–Exchange.DeleteOk 消息的回调

exchange_unbind(destination=None, source=None, routing_key='', arguments=None, callback=None)

取消与另一个交换机的绑定

参数：

destination - 取消绑定的目标交换
source - 取消绑定的源交换
routing_key - 解除绑定的路由键
arguments - 绑定的自定义键/值对参数
callback（callable） - 方法Exchange.UnbindOk的回调（pika.frame.Method）
flow(active, callback=None)
关闭和打开通道流量控制

参数：
active (bool)– Turn flow on or off
callback (callable)– callback(bool) upon completion

is_closed
is_closing
is_open
open()
queue_bind(queue, exchange, routing_key=None, arguments=None, callback=None)
将队列绑定到交换机

参数：
queue（str） - 绑定到交换的队列
exchange（str） - 要绑定的源交换
routing_key（str） - 要绑定的路由键
arguments（dict） - 绑定的自定义键/值对参数
callback（callable） - 方法Queue.BindOk的回调（pika.frame.Method）

queue_declare(queue, passive=False, durable=False, exclusive=False, auto_delete=False, arguments=None, callback=None)
声明队列

参数：
`queue (str)` – 队列名称
`passive (bool) `– 只检察队列是否存在，默认false
`durable (bool)` – 是否持久化队列，以便在重启rabbitmq时候队列能够恢复
`exclusive (bool)` – 排他队列，只允许在该连接connection中使用
`auto_delete (bool) `– 断开连接时候是否自动删除
`arguments (dict) `– 队列的自定义键/值参数
`callback (callable)` – 方法Queue.DeclareOk的回调（pika.frame.Method）
1
2
3
4
5
6
7
8
9
10
queue_delete(queue, if_unused=False, if_empty=False, callback=None)
删除队列

参数：
`queue (str)` – 队列名称
`if_unused (bool)` – 未使用才删除
`if_empty (bool)` – 是否是空的时候才删除
`callback (callable)` –方法Queue.DeleteOk的回调（pika.frame.Method）
1
2
3
4
5
6
7
queue_purge(queue, callback=None)

清除队列的所有消息

queue (str) –队列名称
callback (callable) – 方法Queue.PurgeOk的回调（pika.frame.Method）

queue_unbind(queue, exchange=None, routing_key=None, arguments=None, callback=None)

解除队列绑定

queue (str)– 队列名称
exchange (str) – 交换机名称
routing_key (str) – 路由键
arguments (dict)– 绑定的自定义键/值对参数
callback (callable) – 方法Queue.UnbindOk的回调（pika.frame.Method）

tx_rollback(callback=None)

tx_select(callback=None)

tx_rollback（callback = None)