• (转)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)

     
    技术链接
  • 相关阅读:
    linux shell if 参数
    SHELL输出颜色和闪烁控制
    http层负载均衡之 haproxy实践篇
    linux系统查找大文件脚本
    Nginx的try_files指令和命名location使用实例
    Java SpringMVC实现PC端网页微信扫码支付完整版
    IPTABLES基本例子
    MAC上反编译android apk---apktool, dex2jar, jd-jui安装使用(含手动签名)
    spring mvc 集成freemarker模板
    Python—正则表达式
  • 原文地址:https://www.cnblogs.com/liujiacai/p/15489581.html
Copyright © 2020-2023  润新知