RabbitMQ(python实现)学习之一:简单两点传输“Hello World”的实现
一.基本配置
注意 RabbitMQ支持python、Java、Ruby、PHP、C#等语言的支持,本博客主要是针对python讲解。本博客安装配置是基于ubuntu系统的。
1.1安装配置epel源
$ rpm -Uvh http://dl.fedoraproject.org/pub/ ... ease-6-8.noarch.rpm
1.2安装erlang
$: yum -y install erlang 或者
$:sudo apt-get install erlang
1.3安装rabbitmq-server
$: yum -y install rabbitmq-server 或者
$: sudo apt-get install rabbitmq-server
1.4启动/停止rabbitmq-server
$: sudo service rabbitmq-server start
$: sudo service rabbitmq-server stop
1.5安装RabbitMQ libraries
RabbitMQ遵循AMQP协议,为了使用rabbitmq,你需要一个库来解读这个协议,对于python来说,你需要安装下面库函数中的任意一个即可:
>py-amqplib >txAMQP >pika
本博文以pika库为例,安装如下:
$:sudo pip install pika==0.9.8 或者
$:sudo apt-get install pika==0.9.8
注意:以下内容是在rabbitmq-server启动,运行在标准端口5672的前提下进行的。
二.对英文版的翻译
2.1简介
RabbitMQ相当于一个消息代理,他完成接收和转发消息的功能,你可以把它想成一个邮局,起到中转作用。RabbitMQ会用到一些专业术语,如下:
>Producer:用来发送消息的程序被称为一个producer,我们用‘P’表示:
>Queue:队列,相当于邮箱的作用,他在创建后一直存活与RabbitMQ中,虽然消息可以在你的程序之间流动,但是在这中间的过程中,消息必须存在queue中,一下queue没有大小限制,你可以存无数的消息,(前提你必须预留1GB的硬盘空间),他就相当于一个没有限制的缓存。多个Producer可以发送消息到同一个queue,多个Consumer也可以从同一个queue中接收消息。一个queue可以用下面的图表示,图的上面是queue的名字。
>Consumer:一个用来接收消息的程序称之为Consumer,我们用下面的图表示:
注意,对于Producer和Consumer可以不在同一台host上面,后续博文会做介绍。
2.2两点传输“Hello World!”
需要两个程序,一个用来发送“Hello World!”,一个程序用来接收“Hello World!”并打印到屏幕上面。模型如下:
我们创建一个名字为hello的queue。Producer发送消息到hello的queue,Consumer从名为hello的queue中接收消息。
2.3sending(发送代码实现)
模型如下:
首先我们需要编写一个send.py程序,这个程序将向queue中发送一个消息,第一件事,我们要做的就是与rabbitmq-server建立连接,代码如下:
import pika connection = pika.BlockingConnection(pika.ConnectionParameters(host='localhost')) channel = connection.channel()
如果我们想与不同的host建立连接,只需将‘localhost’换成IP地址。
接下来,我们需要确定接纳消息的queue的存在,如果我们把消息发送给不存在的queue,那么rabbitmq自动将消息丢弃,让我们创建一个消息队列queue,命名为‘hello’
channel.queue_declare(queue='hello')
在Rabbitmq中,一个消息不能直接发送给queue,需要经过一个exchange,后续博文会讲到,现在我们只需将exchange设置为空字符串。
exchange很特别,他会识别我们的消息要发送给哪个消息队列queue,queue的名字需要用routing_key来标识,exchange通过routing_key确定消息发送至哪个消息队列queue。代码如下:
channel.basic_publish(exchange='',routing_key='hello',body='Hello World!') print "[X] Sent 'Hello World!'"
在退出程序之前,我们需要清理缓存,并且确定我们的消息“Hello World!”真的发送给RabbitMQ了,我们可以通过关闭连接来完成,代码如下:
connection.close()
完整的send.py的代码如下:
import pika connection = pika.BlockingConnection(pika.ConnectionParameters( host='localhost')) channel = connection.channel() channel.queue_declare(queue='hello') channel.basic_publish(exchange='', routing_key='hello', body='Hello World!') print " [x] Sent 'Hello World!'" connection.close()
2.4Receiving(接收代码实现)
模型如下所示:
我们的接收程序receive.py将接收消息,并将它打印在屏幕上。
同样首先,我们需要与rabbitmq-server建立连接,代码和send.py基本一致,代码如下:
import pika connection = pika.BlockingConnection(pika.ConnectionParameters(host='localhost')) channel=connection.channel()
接下来,和前面一样,要确定去队列queue的存在,用queue_declare()创建队列,对于这个命令我们可以运行很多次,但只有一个名字为hello的queue存在。代码如下:
channel.queue_declare(queue='hello')
或许你会问,为什么我们要再次创建名字为hello的queue,前面我们已经建立了啊,当然,如果我们确定队列queue已经存在了,我们可以不加这段代码。例如,如果send.py程序在之前已经运行过了,但是我们不确定哪个程序时先运行的,这时候,我们在两个程序中同时声明queue就是必须的。
对于receive.py,我们要定义一个callback函数,在我们接受到消息的时候,pika库会调用callback函数,在我们的程序里,callback函数就是将接收到的消息打印在屏幕上。函数代码如下:
def callback(ch,method,properties,body): print"[x] Received %r" %(body)
接下来我们需要告诉Rabbitmq,这个特殊的函数callback()的功能,就是从hello的queue中接收消息,代码如下:
channel.basic_consume(callback,queue='hello',no_ack=True)
对于代码中的 no_ack,后续的博客会提到。
最后,我们开启一个永不停止的线程来等待消息,在需要的时候运行callback()函数。代码如下:
print '[*] Waiting for message. To exit press CTRL+C' channel.start_consuming()
完整的receive.py的代码如下:
import pika connection = pika.BlockingConnection(pika.ConnectionParameters( host='localhost')) channel = connection.channel() channel.queue_declare(queue='hello') print ' [*] Waiting for messages. To exit press CTRL+C' def callback(ch, method, properties, body): print " [x] Received %r" % (body,) channel.basic_consume(callback, queue='hello', no_ack=True) channel.start_consuming()
2.5代码测试
首先打开一个命令行窗口,运行send.py代码,运行及结果如下:
$ :python send.py [x] Sent 'Hello World!'
send.py每次运行完就停止,接下来让我们运行接收的代码receive.py,运行及结果如下:
$: python receive.py [*] Waiting for messages. To exit press CTRL+C [x] Received 'Hello World!'
你会看到,received.py运行起来后,不会停止,一直在那等待消息的传入,如果想停止,CTRL+C。
在一个新命令行窗口中继续运行send.py,运行receive.py的命令行窗口会继续输出相应信息。
2.6部分rabbitmq-server的命令行操作命令
1)查看各个queue的名称以及queue中的消息数
$: sudo rabbitmqctl list_queues
例如
$: sudo rabbitmqctl list_queues
Listing queues ...
hello 0
...done.
2)查看各exchange的名称
$: sudo rabbitmqctl list_exchanges
例如:
$ :sudo rabbitmqctl list_exchanges
Listing exchanges ...
logs fanout
amq.direct direct
amq.topic topic
amq.fanout fanout
amq.headers headers
...done.
对于上图中,你会看到很多amq.*的exchange,这些是系统默认建立的,在你不建立exchange时,系统默认建立上面几个。
3)查看binding的名称(后续博客会介绍binding)
$: sudo rabbitmqctl list_bindings