RabbitMQ-C 客户端接口使用说明

摘要:
声明一个新的amqpconnectionamqp_connection_state_tamqp_new_connection(void);主机名RabbitMQserver主机端口号RabbitMQ服务器侦听端口intamqp_open_socket(charconst*主机名,

  rabbitmq-c是一个用于C语言的,与AMQP server进行交互的client库。AMQP协议为版本0-9-1。rabbitmq-c与server进行交互前需要首先进行login操作,在操作后,可以根据AMQP协议规范,执行一系列操作。

  这里,根据项目需求,只进行部分接口说明,文后附demo的github地址。

接口描述

  • 接口说明:声明一个新的amqp connection

    amqp_connection_state_t amqp_new_connection(void);

  • 接口说明:获取socket

     参数说明:hostname         RabbitMQ server所在主机

       portnumber      RabbitMQ server监听端口   

    int amqp_open_socket(char const *hostname, int portnumber);

  • 接口说明:将amqp connection和sockfd进行绑定

    void amqp_set_sockfd(amqp_connection_state_t state,int sockfd);

  • 接口说明:用于登录RabbitMQ server,主要目的为了进行权限管理;

    参数说明:state    amqp connection

                     vhost   rabbit-mq的虚机主机,是rabbit-mq进行权限管理的最小单位

                     channel_max  最大链接数,此处设成0即可

                     frame_max  和客户端通信时所允许的最大的frame size.默认值为131072,增大这个值有助于提高吞吐,降低这个值有利于降低时延

                     heartbeat 含义未知,默认值填0

                     sasl_method  用于SSL鉴权,默认值参考后文demo

    amqp_rpc_reply_t amqp_login(amqp_connection_state_t state, char const *vhost,int channel_max,int frame_max,int heartbeat,amqp_sasl_method_enum sasl_method, ...);

  • 接口说明:用于关联conn和channel

    amqp_channel_open_ok_t *amqp_channel_open(amqp_connection_state_t state, amqp_channel_t channel);

  • 接口说明:声明declare

   参数说明:state

                         channel

                           exchange

                           type     "fanout"  "direct" "topic"三选一

                           passive

                           curable

                           arguments

          amqp_exchange_declare_ok_t *amqp_exchange_declare(amqp_connection_state_t state, amqp_channel_t channel, amqp_bytes_t exchange, amqp_bytes_t type, amqp_boolean_t passive, amqp_boolean_t durable, amqp_table_t arguments); 

  • 接口说明:声明queue

      参数说明:state   amqp connection

                  channel 

                  queue  queue name

                  passive 

                  durable  队列是否持久化

                  exclusive  当前连接不在时,队列是否自动删除

                  aoto_delete 没有consumer时,队列是否自动删除

                  arguments 用于拓展参数,比如x-ha-policy用于mirrored queue

   amqp_queue_declare_ok_t *amqp_queue_declare(amqp_connection_state_t state, amqp_channel_t channel, amqp_bytes_t queue, amqp_boolean_t passive, amqp_boolean_t durable, amqp_boolean_t exclusive, amqp_boolean_t auto_delete, amqp_table_t arguments); 

  • 接口说明:声明binding   

   amqp_queue_bind_ok_t *amqp_queue_bind(amqp_connection_state_t state, amqp_channel_t channel, amqp_bytes_t queue, amqp_bytes_t exchange, amqp_bytes_t routing_key, amqp_tab le_t arguments);

  • 接口说明:qos是 quality of service,我们这里使用主要用于控制预取消息数,避免消息按条数均匀分配,需要和no_ack配合使用

        参数说明:state

                   channel

                   prefetch_size 以bytes为单位,0为unlimited

                   prefetch_count 预取的消息条数

                   global

  amqp_basic_qos_ok_t *amqp_basic_qos(amqp_connection_state_t state, amqp_channel_t channel, uint32_t prefetch_size, uint16_t prefetch_count, amqp_boolean_t global);

  • 接口说明:开始一个queue consumer

        参数说明:state

                   channel

                   queue

                   consumer_tag

                   no_local

                   no_ack    是否需要确认消息后再从队列中删除消息

                   exclusive

                   arguments

  amqp_basic_consume_ok_t *amqp_basic_consume(amqp_connection_state_t state, amqp_channel_t channel, amqp_bytes_t queue, amqp_bytes_t consumer_tag, amqp_boolean_t no_local, amqp_boolean_t no_ack, amqp_boolean_t exclusive, amqp_table_t arguments); 

  • 接口说明:发布消息

      参数说明:state 

                  channel

                  exchange  

                  routing_key  当exchange为默认“”时,此处填写queue_name,当exchange为direct,此处为binding_key

                  mandatory 参见参考文献2

                  immediate 同上

                  properties 更多属性,如何设置消息持久化,参见文后demo

                  body 消息体

   int amqp_basic_publish(amqp_connection_state_t state,amqp_channel_t channel,amqp_bytes_t exchange,amqp_bytes_t routing_key,amqp_boolean_t mandatory,amqp_boolean_t immediate,struct amqp_basic_properties_t_ const *properties,amqp_bytes_t body);

  amqp_rpc_reply_t amqp_channel_close(amqp_connection_state_t state,amqp_channel_t channel,int code);

  amqp_rpc_reply_t amqp_connection_close(amqp_connection_state_t state,int code);

  int amqp_destroy_connection(amqp_connection_state_t state);

   如何consume消息,参见文后demo。

 demo

https://github.com/liuhaobupt/rabbitmq_work_queues_demo-with-rabbit-c-client-lib

其中 rmq_new_task.c和rmq_worker.c对应于RabbitMQ tutorial里的work queues章节(http://www.rabbitmq.com/tutorials/tutorial-two-python.html),emit_log_direct.c和receive_logs_direct.c对应于RabbitMQ tutorial里的routing章节(http://www.rabbitmq.com/tutorials/tutorial-four-python.html),这两个demo覆盖了RabbitMQ的常用应用场景。

编译需要librabbitmq.a库,同时需要rabbitmq-c提供的几个头文件(amqp.h和amqp_framing.h)以及utils.c文件,这些在github project页面均可获得。

参考文献
  1. rabbitmq-c主页 http://hg.rabbitmq.com/rabbitmq-c/summary
  2. http://www.rabbitmq.com/amqp-0-9-1-reference.html
 转自:http://www.cnblogs.com/liuhao/archive/2012/04/13/2445641.html

免责声明:文章转载自《RabbitMQ-C 客户端接口使用说明》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇谷歌提高Google Assistant中Voice Match的准确性C语言中 有符号数、无符号数、整数溢出 (转)下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

面试 -- 核心篇 -- 中间件(消息)

面试 -- 核心篇 -- 中间件(消息) 消息队列的应用场景参考网址:消息队列的四种应用场景         消息队列设计思路 (1)异步处理 用户注册时,可以同时将 发送邮件 和 发送短信 功能放到消息队列中实现。可以提高用户响应时间,提高系统吞吐量。 (2)应用解耦 用户下单和库存扣账中使用消息,可以防止库存系统出问题后,导致用户下单失败。 (3...

odoo里的开发规范

1、模块命名[驼峰命名方法] res开头的是:resources   常见模型:res.users,   res.company,    res.partner,   res.config.settings   等。。。 @api.modeldef _selection_grade(self): res_grade = [] grade_lis...

UI自动化自动验证登录滑动拼图验证码

用于UI自动化登录拼图滑动验证码 1 #!/usr/bin/env python 2 # -*- coding: utf-8 -*- 3 # @Time : 2019/11/15 14:32 4 # @Site : 5 # @File : puzzleCaptcha.py 6 # @Software: PyCha...

(已解决)Could not open '/var/lib/nova/mnt/*/volume-*': Permission denied

【问题描述】 创建boot_from_volume的虚机时,磁盘后端为NFS,创建失败。     【错误日志】 nova-compute模块 Could not open '/var/lib/nova/mnt/b4a8885bf81bd517182c73c35df4496d/volume-598ddf2f-94c6-495d-b57b-20ebf2c...

influxDB学习总结

1.安装    请参考http://www.cnblogs.com/zhja/p/5996191.html,    安装完毕运行influxd,http://域名:8083为控制台界面;http://域名:8086为api地址;运行influx进入命令行模式。 2.go操作influxdb   1)利用influxdb的client,github地址:gi...

ovn-kubernetes执行流程概述

Master部分 1、master初始化 以node name创建一个distributed logical router 创建两个load balancer用于处理east-west traffic,一个处理TCP,另一个处理UDP 创建一个名为"join"的logical switch用于连接gateway router和distributed ro...