Windows下本地RabbitMQ服务的安装(V3.01)

当然这些内容页可以通过RabbitMQ官方网站获得。

RabbitMQ安装：

一、RaibbitMQ服务器安装

1． 准备工作。如果之前安装过RabbitMQ软件，若想重新安装，必须先把之前的RabbitMQ相关软件卸载。

2． 安装ERLANG语言包。首先到http://www.erlang.org/download.html这个页面下载 Erlang Windows Binary File并且运行。这个过程大约5分钟左右。

安装具体过程：

1.右键，管理员身份运行：otp_win32_R16801.exe(不同版本可能命名字不一样)，选择next

 如果不是管理员身份运行，启动Rabbitmq不能成功：Failed to start service RabbitMQ. Error: 拒绝访问。

解决办法：卸载，清理注册表重新安装erlang，先卸载RabbitMQ和Erlang，再清理注册表。

清理的时候如果找不到注册表项，可以用注册表的搜索功能搜索：RabbitMQ、ErlSrv，将对应的项全部删除。

2.默认安装在C盘，建议程序安装在非系统盘比如D盘（如果安装在C盘可能会出现一些权限问题），修改好安装路径后，选next：

3.进入安装程序，选择install，即可完成安装：

3． 安装RabbitMQ服务器软件。到这个页面下载：

http://www.rabbitmq.com/releases/rabbitmq-server/v3.1.3/rabbitmq-server-3.1.3.exe。然后运行安装。

安装具体过程：

1. 双击rabbitmq-server-3.1.1.exe。选择next:

 

2.  默认安装在C盘，直接安装即可。

4． 还需要配置环境变量:

 4.1给path变量添加内容，在其后面增加：;%RABBITMQ_SERVER%\sbin （注意前面的分号），然后确定即可

 4.2 添加环境变量：RABBITMQ_SERVER 

环境变量RABBITMQ_SERVER 的值为：D:\My-Softwar-Installed\RabbitMQ Server\rabbitmq_server-3.1.3

现在打开windows命令行（“cmd”），输入rabbitmq-service

如果出现如下所示提示，即表示环境变量配置成功。

 安装完成之后可以在系统的服务中看到RabbitMQ这个服务。

5． Rabbit还自带监控功能. 
cmd进到sbin目录，键入rabbitmq-plugins enable rabbitmq_management启用监控管理，然后重启Rabbitmq服务器。 打开网址http://localhost:55672，用户名和密码都是guest。 

 

6． 现在打开浏览器，输入：http://localhost:15672/ ，如果出现以下页面，则表示服务器配置成功。

 

默认用户名为guest,密码：guest

如果没有出现以上页面，尝试在windows命令行中输入(以管理员方式运行)：

rabbitmq-plugins enable rabbitmq_management

然后运行下面的命令来安装：

rabbitmq-service stop

rabbitmq-service install

rabbitmq-service start

二、 使用VS2010编译RibbitMQ

1. 下载 rabbitmq-c-master 源码 

2. 下载 rabbitmq-codegen 源码 

3. 将 rabbitmq-codegen 中的内容拷贝到 rabbitmq-c-master 中的 codegen 目录下（如果没有该目录请自行创建）.

4. 下载 cmake 并安装。

 

按下一步直接安装：

 

      这里可以更改路径（注意安装路径不要包含中文）,安装完毕即可。这时桌面会生成一个cmake_gui的快捷方式。

5. 使用cmake编译rabbitmq-c源码。

打开cmake。

 

source处（红圈处）填你的rabbitmq-c-master源码路径，比如我放在d:/rabbitmq-c-master；下面的build处（黄圈处）填你source处的下面build文件夹（如果没有build文件夹则创建一个）

点configure，这时会询问选择何种编译器，选择VS2010。

 

点finish。这时cmake会开始编译，但是一会他可能会弹出如下错误信息:

直接把ENABLE_SSL_SUPPORT去掉，再按configure即可。

等编译完成，再点Generate按钮。整个编译过程即完成。

6. 打开VS2010。用VS2010打开rabbit-c-master/build下的rabbitmq-c.sln项目

 

7. 点击生成/生成解决方案（或按F7）

 

8. 项目此时会生成好：

 

9. 将D:\rabbitmq-c-master\build\librabbitmq\Debug下(注意D:\rabbitmq-c-master\build为前面cmake编译生成文件路径，下同)的rabbitmq.1.dll动态连接库拷到D:\rabbitmq-c-master\rabbitmq-c-master\build\examples\Debug文件夹下。

10. 现在所有的rabbit-c的example都可以运行了。至此，可以按照 https://github.com/alanxz/rabbitmq-c 上的说明，执行测试了。

打开“cmd”，进入到D:\rabbitmq-c-master\build\examples\Debug文件夹下：

 

输入amqp_listen.exe localhost 5672 amq.direct test:

 

再在另一个cmd中也到达D:\rabbitmq-c-master\build\examples\Debug

输入amqp_sendstring.exe localhost 5672 amq.direct test 

“hello world”

 

运行之后如果第一个终端出现如下界面，则说明整个rabbitMQ配置成功。

至此，说明Raabit-C客户端与服务端都以成功。

 

 

 

RabbitMQ使用说明

一、 基本概念：

 

（一）基本概念

RabbitMQ是流行的开源消息队列系统，用erlang语言开发。我曾经对这门语言挺有兴趣，学过一段时间，后来没坚持。RabbitMQ是AMQP（高级消息队列协议）的标准实现。如果不熟悉AMQP，直接看RabbitMQ的文档会比较困难。不过它也只有几个关键概念，这里简单介绍。

RabbitMQ的结构图如下：

 

 

几个概念说明：

Broker：简单来说就是消息队列服务器实体。
Exchange：消息交换机，它指定消息按什么规则，路由到哪个队列。
Queue：消息队列载体，每个消息都会被投入到一个或多个队列。
Binding：绑定，它的作用就是把exchange和queue按照路由规则绑定起来。
Routing Key：路由关键字，exchange根据这个关键字进行消息投递。
vhost：虚拟主机，一个broker里可以开设多个vhost，用作不同用户的权限分离。
producer：消息生产者，就是投递消息的程序。
consumer：消息消费者，就是接受消息的程序。
channel：消息通道，在客户端的每个连接里，可建立多个channel，每个channel代表一个会话任务。

消息队列的使用过程大概如下：

（1）客户端连接到消息队列服务器，打开一个channel。
（2）客户端声明一个exchange，并设置相关属性。
（3）客户端声明一个queue，并设置相关属性。
（4）客户端使用routing key，在exchange和queue之间建立好绑定关系。
（5）客户端投递消息到exchange。

exchange接收到消息后，就根据消息的key和已经设置的binding，进行消息路由，将消息投递到一个或多个队列里。

exchange也有几个类型，完全根据key进行投递的叫做Direct交换机，例如，绑定时设置了routing key为”abc”，那么客户端提交的消息，只有设置了key为”abc”的才会投递到队列。对key进行模式匹配后进行投递的叫做Topic交换机，符号”#”匹配一个或多个词，符号”*”匹配正好一个词。例如”abc.#”匹配”abc.def.ghi”，”abc.*”只匹配”abc.def”。还有一种不需要key的，叫做Fanout交换机，它采取广播模式，一个消息进来时，投递到与该交换机绑定的所有队列。

RabbitMQ支持消息的持久化，也就是数据写在磁盘上，为了数据安全考虑，我想大多数用户都会选择持久化。消息队列持久化包括3个部分：
（1）exchange持久化，在声明时指定durable => 1
（2）queue持久化，在声明时指定durable => 1
（3）消息持久化，在投递时指定delivery_mode => 2（1是非持久化）

如果exchange和queue都是持久化的，那么它们之间的binding也是持久化的。如果exchange和queue两者之间有一个持久化，一个非持久化，就不允许建立绑定。

RabbitMQ-C客户端使用说明 rabbitmq-c是一个用于C语言的，与AMQP server进行交互的client库，AMQP协议为版本0-9-1。rabbitmq-c与server进行交互前需要首先进行login操作，在操作后，可以根据AMQP协议规范，执行一系列操作。 这里，根据项目需求，只进行部分接口说明，文后附demo的github地址。 接口描述： amqp_connection_state_t amqp_new_connection(void); 接口说明：声明一个新的amqp connection int amqp_open_socket(char const *hostname, int portnumber); 接口说明：获取socket.

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

portnumber RabbitMQ server监听端口 

void amqp_set_sockfd(amqp_connection_state_t state,int sockfd);

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

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, ...);

接口说明：用于登录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_channel_open_ok_t *amqp_channel_open(amqp_connection_state_t state, amqp_channel_t channel);

接口说明：用于关联conn和channel

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); 

接口说明：声明declare

参数说明：state

channel

exchange

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

passive

curable

arguments

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); 

接口说明：声明queue

参数说明：state amqp connection

channel 

queue queue name

passive 

durable 队列是否持久化

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

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

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

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);

接口说明：声明binding 

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);

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

参数说明：state

channel

prefetch_size 以bytes为单位，0为unlimited

prefetch_count 预取的消息条数

global

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); 

接口说明：开始一个queue consumer

参数说明：state

channel

queue

consumer_tag

no_local

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

exclusive

arguments

int amqp_basic_ack(amqp_connection_state_t state,amqp_channel_t channel,uint64_t delivery_tag,amqp_boolean_t multiple);

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);

接口说明：发布消息

参数说明：state 

channel

exchange 

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

mandatory 参见参考文献2

immediate 同上

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

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

RabbitMQ-C客户端使用说明 rabbitmq-c是一个用于C语言的，与AMQP server进行交互的client库，AMQP协议为版本0-9-1。rabbitmq-c与server进行交互前需要首先进行login操作，在操作后，可以根据AMQP协议规范，执行一系列操作。 这里，根据项目需求，只进行部分接口说明，文后附demo的github地址。 接口描述： amqp_connection_state_t amqp_new_connection(void); 接口说明：声明一个新的amqp connection int amqp_open_socket(char const *hostname, int portnumber); 接口说明：获取socket. 参数说明：hostname RabbitMQ server所在主机 portnumber RabbitMQ server监听端口  void amqp_set_sockfd(amqp_connection_state_t state,int sockfd); 接口说明：将amqp connection和sockfd进行绑定 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, ...); 接口说明：用于登录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_channel_open_ok_t *amqp_channel_open(amqp_connection_state_t state, amqp_channel_t channel); 接口说明：用于关联conn和channel 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);  接口说明：声明declare 参数说明：state channel exchange type "fanout" "direct" "topic"三选一 passive curable arguments 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);  接口说明：声明queue 参数说明：state amqp connection channel  queue queue name passive  durable 队列是否持久化 exclusive 当前连接不在时，队列是否自动删除 aoto_delete 没有consumer时，队列是否自动删除 arguments 用于拓展参数，比如x-ha-policy用于mirrored queue 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); 接口说明：声明binding  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); 接口说明：qos是 quality of service，我们这里使用主要用于控制预取消息数，避免消息按条数均匀分配，需要和no_ack配合使用 参数说明：state channel prefetch_size 以bytes为单位，0为unlimited prefetch_count 预取的消息条数 global 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);  接口说明：开始一个queue consumer 参数说明：state channel queue consumer_tag no_local no_ack 是否需要确认消息后再从队列中删除消息 exclusive arguments int amqp_basic_ack(amqp_connection_state_t state,amqp_channel_t channel,uint64_t delivery_tag,amqp_boolean_t multiple); 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); 接口说明：发布消息 参数说明：state  channel exchange  routing_key 当exchange为默认“”时，此处填写queue_name，当exchange为direct，此处为binding_key mandatory 参见参考文献2 immediate 同上 properties 更多属性，如何设置消息持久化，参见文后demo 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://lostechies.com/derekgreer/tag/rabbitmq/ http://www.rabbitmq.com/getstarted.html （中文翻译 http://adamlu.net/dev/2011/09/rabbitmq-get-started/ ） http://alanxz.github.io/rabbitmq-c/docs/0.2/annotated.html https://github.com/liuhaobupt/rabbitmq_work_queues_demo-with-rabbit-c-client-lib   六、 简单代码解释（头文件略去） // 下面提供了一个简单消费者代码demo，包括了RabbitMQ的绝大多数流程 // 实现了从默认交换机，队列名为“QueueName1”中消息的获取

nt main(int argc, const char **argv) {

const char *hostname = "localhost";  // 主机名

int port = 5672;   // 端口

const char *exchange = "";   //交换机为默认时设为空字符串

const char *queuename = "QueueName1";   // 队列名

amqp_socket_t *socket = NULL;

int sockfd;

int channelid = 1;   // 默认打开的频道

amqp_connection_state_t conn;

conn = amqp_new_connection();  // 新建一个连接

socket = amqp_tcp_socket_new(conn);  // 新建一个套接字

die_on_error(sockfd = amqp_socket_open(socket,hostname, port), "Opening socket");  //打开套接字

die_on_amqp_error(amqp_login(conn, "/", 0, 131072, 0, AMQP_SASL_METHOD_PLAIN, "guest", "guest"),"Logging in");   // 登录服务器

amqp_channel_open(conn, channelid);  // 打开一个频道

die_on_amqp_error(amqp_get_rpc_reply(conn), "Opening channel");   // ampq_get_rpc_reply 是一个清除某些全局变量的函数

 

amqp_queue_declare(conn,channelid,amqp_cstring_bytes(queuename),0,1,0,0,amqp_empty_table);  // 声明一个队列,注意对照API看参数信息

 

amqp_basic_qos(conn,channelid,0,1,0);  //基本服务处理，可实现预先处理多少个信息

amqp_basic_consume(conn,channelid,amqp_cstring_bytes(queuename),amqp_empty_bytes,0,1,0,amqp_empty_table);   // 开始一个队列消费

die_on_amqp_error(amqp_get_rpc_reply(conn), "Consuming");

{

while (1) {

amqp_rpc_reply_t res;

amqp_envelope_t envelope;

amqp_maybe_release_buffers(conn);  //清除缓存

res = amqp_consume_message(conn, &envelope, NULL, 0);  //将获得的消息交给envelope

if (AMQP_RESPONSE_NORMAL != res.reply_type) {

break;

}

printf("Delivery %u, exchange %.*s routingkey %.*s\n",

             (unsigned) envelope.delivery_tag,

             (int) envelope.exchange.len, (char *) envelope.exchange.bytes,

             (int) envelope.routing_key.len, (char *) envelope.routing_key.bytes);

printf("Content %.*s",(int)envelope.message.body.len,(char *)envelope.message.body.bytes);

 amqp_destroy_envelope(&envelope);

}

}

die_on_amqp_error(amqp_channel_close(conn, 1, AMQP_REPLY_SUCCESS), "Closing channel");  // 关闭频道

die_on_amqp_error(amqp_connection_close(conn, AMQP_REPLY_SUCCESS), "Closing connection");   // 关闭连接

die_on_error(amqp_destroy_connection(conn), "Ending connection"); // 销毁连接

return 0;

}