使用EasyNetQ组件操作RabbitMQ消息队列服务
RabbitMQ是一个由erlang开发的AMQP(Advanved Message Queue)的开源实现,是实现消息队列应用的一个中间件,消息队列中间件是分布式系统中重要的组件,主要解决应用耦合,异步消息,流量削锋等问题。实现高性能,高可用,可伸缩和最终一致性架构。是大型分布式系统不可缺少的中间件。EasyNetQ则是基于官方.NET组件RabbitMQ.Client 的又一层封装,使用起来更加方便。本篇随笔主要大概介绍下RabbitMQ的基础知识和环境的准备,以及使用EasyNetQ的相关开发调用。
1、RabbitMQ基础知识
AMQP,即Advanced Message Queuing Protocol,高级消息队列协议,是应用层协议的一个开放标准,为面向消息的中间件设计。消息中间件主要用于组件之间的解耦,消息的发送者无需知道消息使用者的存在,反之亦然。
AMQP的主要特征是面向消息、队列、路由(包括点对点和发布/订阅)、可靠性、安全。
RabbitMQ 是一个开源的AMQP实现,服务器端用Erlang语言编写,支持多种客户端,如:Python、Ruby、.NET、Java、JMS、C、PHP、ActionScript、XMPP、STOMP等,支持AJAX。用于在分布式系统中存储转发消息,在易用性、扩展性、高可用性等方面表现不俗。
RabbitMQ的特点:强大的应用程序消息传递;使用方便;运行在所有主要操作系统上;支持大量开发人员平台;开源和商业支持。消息队列的模式有两种模式:P2P(Point to Point),P2P模式包含三个角色:消息队列(Queue),发送者(Sender),接收者(Receiver)。每个消息都被发送到一个特定的队列,接收者从队列中获取消息。队列保留着消息,直到他们被消费或超时。Publish/Subscribe(Pub/Sub),包含三个角色主题(Topic),发布者(Publisher),订阅者(Subscriber) 。多个发布者将消息发送到Topic,系统将这些消息传递给多个订阅者。
EasyNetQ 的目标是提供一个使.NET中的RabbitMQ尽可能简单的库。在EasyNetQ中消息应由.NET类型表示,消息应通过其.NET类型进行路由。EasyNetQ按消息类型进行路由。发布消息时,EasyNetQ会检查其类型,并根据类型名称,命名空间和装配体给出一个路由密钥。在消费方面,用户订阅类型。订阅类型后,该类型的消息将路由到订户。默认情况下,EasyNetQ使用Newtonsoft.Json库将.NET类型序列化为JSON。这具有消息是人类可读的优点,因此您可以使用RabbitMQ管理应用程序等工具来调试消息问题。
EasyNetQ是在RabbitMQ.Client库之上提供服务的组件集合。这些操作可以像序列化,错误处理,线程编组,连接管理等。它们由mini-IoC容器组成。您可以轻松地用自己的实现替换任何组件。因此,如果您希望XML序列化而不是内置的JSON,只需编写一个ISerializer的实现并将其注册到容器。以下是官方提供的一个结构图,这个结构图可以很好的解析该组件的结构:
2、RabbitMQ的环境准备
本处主要介绍在Windows系统中安装RabbitMQ。
1. 下载安装erlang
下载地址 http://www.erlang.org/downloads(根据操作系统选择32还64位)
2. 下载安装rabbitmq-server
下载地址 http://www.rabbitmq.com/install-windows.html
下载后获得两个安装文件,按照顺序安装即可
安装erlang环境后,一般会添加了一个ERLANG_HOME的系统变量,指向erlang的安装目录路径,如下所示(一般都添加了,确认下)
安装RabbitMQ后,在程序里面可以看到
我们使用它的命令行来启动RabbitMQ的服务
查看安装是否成功命令 :rabbitmqctl status
安装成功,在浏览器中输入 http://127.0.0.1:15672/,可以看到如下界面,使用默认的账号密码均为guest登陆进行管理
guest 账号是管理员账号,可以添加Exchanges,Queues,Admin。但我们一般不使用guest账号,可以选择用命令来添加账号和权限,也可以使用管理界面进行添加相应的内容。
例如我添加相应的用户账号
一般我们还需要添加虚拟机,默认的虚拟机为/,我这里添加了一个虚拟机myvhost。
然后绑定账号到虚拟机上即可。
3、EasyNetQ组件的使用
EasyNetQ组件的使用方式比较简单,跟很多组件都类似,例如:建立连接,进行操作做等等,对于EasyNetQ组件也是如此。
在.NET中使用EasyNetQ,要求至少基于 .NET4.5的框架基础上进行开发,可以直接在VS项目上使用NuGet的程序包进行添加EasyNetQ的引用。
一般添加引用后,至少包含了下面图示的几个引用DLL。
1)创建连接:
使用EasyNetQ连接RabbitMQ,是在应用程序启动时创建一个IBus对象,并且,在应用程序关闭时释放该对象。
RabbitMQ连接是基于IBus接口的,当IBus中的方法被调用,连接才会开启。创建一个IBus对象的方法如下:
var bus = RabbitHutch.CreateBus(“host=myServer;virtualHost=myVirtualHost;username=admin;password=”);
与RabbitMQ服务器的延迟连接由IBus接口表示,创建连接的方式连接字符串由格式为key = value的键/值对组成,每一个用分号(;)分隔。
- host,host=localhost 或者host =192.168.1.102或者host=my.rabbitmq.com,如果用到集群配置的话,那么可以用逗号将服务地址隔开,例如host=a.com,b.com,c.com
- virtualHost,虚拟主机,默认为'/'
- username,用户登录名
- password,用户登录密码
- requestedHeartbeat,心跳设置,默认是10秒
- prefetchcount,默认是50
- pubisherConfirms,默认为false
- persistentMessages,消息持久化,默认为true
- product,产品名
- platform,平台
- timeout,默认为10秒
一般我们在代码里面测试的话,简化连接代码如下所示。
//初始化bus对象
bus = RabbitHutch.CreateBus("host=localhost");
2)关闭连接:
bus.Dispose();
要关闭连接,只需简单地处理总线,这将关闭EasyNetQ使用的连接,渠道,消费者和所有其他资源。
如果我们在Winform窗体里面初始化一个IBus对象,那么在窗体关闭的时候,关闭这个接口即可。
private void FrmPublisher_FormClosed(object sender, FormClosedEventArgs e)
{
//关闭IBus接口
if(bus != null)
{
bus.Dispose();
}
}
3)发布消息:
EasyNetQ支持最简单的消息模式是发布和订阅。发布消息后,任意消费者可以订阅该消息,也可以多个消费者订阅。并且不需要额外配置。首先,如上文中需要先创建一个IBus对象,然后,在创建一个可序列化的.NET对象。调用Publish方法即可。
var message = new MyMessage { Text = "Hello Rabbit" };
bus.Publish(message);
4)订阅消息:
EasyNetQ提供了消息订阅,当调用Subscribe方法时候,EasyNetQ会创建一个用于接收消息的队列,不过与消息发布不同的是,消息订阅增加了一个参数,subscribe_id.代码如下:
bus.Subscribe<MyMessage>("my_subscription_id", msg => Console.WriteLine(msg.Text));
第一个参数是订阅id,另外一个是delegate参数,用于处理接收到的消息。这里要注意的是,subscribe_id参数很重要,假如开发者用同一个subscribeid订阅了同一种消息类型两次或者多次,RabbitMQ会以轮训的方式给每个订阅的队列发送消息。接收到之后,其他队列就接收不到该消息。如果用不同的subscribeid订阅同一种消息类型,那么生成的每一个队列都会收到该消息。
需要注意的是,在收到消息处理消息时候,不要占用太多的时间,会影响消息的处理效率,所以,遇到占用长时间的处理方法,最好用异步处理。
为了测试发布和订阅消息,我们可以建立几个不同的项目来进行测试,如发布放在一个Winform项目,订阅放在一个Winform项目,另外一个项目放置共享的消息对象定义,如下所示。
定义消息对象类如下所示。
/// <summary>
/// 定义的MQ消息类型
/// </summary>
public class TextMessage
{
public string Text { get; set; }
}
然后在发布消息的Winform项目上创建一个处理的窗体,并添加如下代码。
namespace MyRabbitMQ.Publisher
{
/// <summary>
/// 测试RabbitMQ消息队列的发布
/// </summary>
public partial class FrmPublisher : DevExpress.XtraEditors.XtraForm
{
//构建一个IBus公用接口对象
private IBus bus = null; public FrmPublisher()
{
InitializeComponent(); //初始化bus对象
bus = RabbitHutch.CreateBus("host=localhost");
//对指定消息类型进行回应
bus.Respond<MyRequest, MyResponse>(request => new MyResponse { Text = "Responding to: "+ request.Text}); //收到消息后输出到控制台上显示
bus.Receive("my.queue", x => x
.Add<MyMessage>(message => Console.WriteLine(message.ToJson()))
.Add<MyOtherMessage>(message => Console.WriteLine(message.ToJson())));
}
发布消息的处理代码,如下代码所示。
private void btnSend_Click(object sender, EventArgs e)
{
if (bus != null)
{
bus.Publish(new TextMessage
{
Text = this.txtContent.Text
});
}
}
然后在创建一个类似窗体,用来订阅消息的处理窗体,如下所示代码和窗体。
namespace MyRabbitMQ.Subcriber
{
/// <summary>
/// 测试RabbitMQ消息队列的订阅
/// </summary>
public partial class FrmSubcriber : DevExpress.XtraEditors.XtraForm
{
//构建一个IBus公用接口对象
private IBus bus = null; public FrmSubcriber()
{
InitializeComponent(); //初始化bus对象
bus = RabbitHutch.CreateBus("host=localhost");
if(bus != null)
{
//订阅一个消息,并对接收到的消息进行处理,展示在控件上
bus.Subscribe<TextMessage>("test", (msg) =>
{
StringBuilder sb = new StringBuilder();
sb.AppendLine(msg.Text + "," + DateTime.Now.ToString());
sb.AppendLine(this.txtContent.Text); this.txtContent.Invoke(new MethodInvoker(delegate()
{
this.txtContent.Text = sb.ToString();
}));
});
} //使用消息发送接口发送消息
bus.Send("my.queue", new MyMessage { Text = "Hello Widgets!" });
bus.Send("my.queue", new MyOtherMessage { Text = "Hello wuhuacong!" });
}
发送请求获取响应的代码如下所示。
private void btnRequest_Click(object sender, EventArgs e)
{
//定义请求消息的对象
var request = new MyRequest()
{
Text = string.Format("请求消息,{0}", DateTime.Now)
}; //异步获取请求消息的结果并进行处理,展示应答消息在窗体中的
var task = bus.RequestAsync<MyRequest, MyResponse>(request);
task.ContinueWith(response =>
{
StringBuilder sb = new StringBuilder();
sb.AppendLine(response.Result.Text);
sb.AppendLine(this.txtContent.Text);
this.txtContent.Invoke(new MethodInvoker(delegate()
{
this.txtContent.Text = sb.ToString();
}));
});
}
两个项目联合进行测试如下界面所示。
发布者多次发送消息的情况下,订阅者中,会进行消息的轮训处理,也就是进行均匀分配。
5)消息发送(Send)和接收(Receive)
与Publish/Subscribe略有不同的是,Send/Receive 可以自己定义队列名称。
//发送端代码
bus.Send("my.queue", new MyMessage{ Text = "Hello Widgets!" }); //接收端代码
bus.Receive<MyMessage>("my.queue", message => Console.WriteLine("MyMessage: {0}", message.Text));
并且,也可以在同一个队列上发送不同的消息类型,Receive方法可以这么写:
bus.Receive("my.queue", x => x
.Add<MyMessage>(message => deliveredMyMessage = message)
.Add<MyOtherMessage>(message => deliveredMyOtherMessage = message));
如果消息到达队列,但是没有发现相应消息类型的处理时,EasyNetQ会发送一条消息到error队列,并且,带上一个异常信息:No handler found for message type <message type>。与Subscribe类型,如果在同一个队列,同一个消息类型,多次调用Receive方法时,消息会通过轮询的形式发送给每个Receive端。
6)远程过程调用:
var request = new TestRequestMessage {Text = "Hello from the client! "};
bus.Request<TestRequestMessage, TestResponseMessage>(request, response =>
Console.WriteLine("Got response: '{0}'", response.Text));
7)RPC服务器:
bus.Respond<TestRequestMessage, TestResponseMessage>(request =>
new TestResponseMessage{ Text = request.Text + " all done!" });
8)记录器:
var logger = new MyLogger() ;
var bus = RabbitHutch.CreateBus(“my connection string”, x => x.Register<IEasyNetQLogger>(_ => logger));
9)路由:
Publish方法,可以加一个topic参数。
bus.Publish(message, "X.A");
消息订阅方可以通过路由来过滤相应的消息。
* 匹配一个字符
#匹配0个或者多个字符
所以 X.A.2 会匹配到 "#", "X.#", "*.A.*" 但不会匹配 "X.B.*" 或者 "A". 当消息订阅需要用到topic时候,需要调用Subscribe的重载方法
bus.Subscribe("my_id", handlerOfXDotStar, x => x.WithTopic("X.*"));
bus.Subscribe("my_id", handlerOfStarDotB, x => x.WithTopic("*.B"));
上述这种方式,会将消息轮询发送给两个订阅者,如果只需要一个订阅者的话,可以这么调用:
bus.Subscribe("my_id", handler, x => x.WithTopic("X.*").WithTopic("*.B"));
RabbitMQ具有非常好的功能,基于主题的路由,允许订阅者基于多个标准过滤消息。*(星号)匹配一个字。#(哈希)匹配为零个或多个单词。
RabbitMQ的应用场景,一般在快速处理订单,以及异步的多任务处理中可以得到很好的体现,下面是几个应用场景。
邮件和短消息的处理
订单的解耦处理
RabbitMQ的服务器架构
3、RabbitMQ查询状态出现错误的处理
安装成功之后使用rabbitmqctl status命令之后出现如下错误。
Status of node rabbit@WUHUACONG ...
Error: unable to perform an operation on node 'rabbit@WUHUACONG'. Please see diagnostics information and suggestions below. Most common reasons for this are: * Target node is unreachable (e.g. due to hostname resolution, TCP connection or firewall issues)
* CLI tool fails to authenticate with the server (e.g. due to CLI tool's Erlang cookie not matching that of the server)
* Target node is not running In addition to the diagnostics info below: * See the CLI, clustering and networking guides on http://rabbitmq.com/documentation.html to learn more
* Consult server logs on node rabbit@WUHUACONG DIAGNOSTICS
=========== attempted to contact: [rabbit@WUHUACONG] rabbit@WUHUACONG:
* connected to epmd (port 4369) on WUHUACONG
* epmd reports node 'rabbit' uses port 25672 for inter-node and CLI tool traffic
* TCP connection succeeded but Erlang distribution failed * Authentication failed (rejected by the remote node), please check the Erlang cookie Current node details:
* node name: rabbitmqcli100@WUHUACONG
* effective user's home directory: C:\Users\Administrator
* Erlang cookie hash: RgaUM2coc+rxIhJrfLS7Jw==
这个问题出现比较常见,主要原因是两个目录的.erlang.cookie文件内容不一样。
要确保.erlang.cookie文件的一致性,不知道什么原因导致了C:\Users\{UserName}\.erlang.cookie和默认情况下C:\WINDOWS\System32\config\systemprofile\.erlang.cookie不一致了,将Windows目录下的拷贝到用户目录下就可以了。
反正无论如何,两个地址的Cookie内容一致就可以了,然后重启下RabbitMQ服务器即可正常运行,并可以正常获取它的状态信息。
使用EasyNetQ组件操作RabbitMQ消息队列服务的更多相关文章
- (四)RabbitMQ消息队列-服务详细配置与日常监控管理
原文:(四)RabbitMQ消息队列-服务详细配置与日常监控管理 RabbitMQ服务管理 启动服务:rabbitmq-server -detached[ /usr/local/rabbitmq/sb ...
- Python操作rabbitmq消息队列持久化
消息队列持久化 Python操作rabbit消息队列的持久化,如下: # 创建一个名为balance的队列,对queue进行durable持久化设为True(持久化第一步)channel.queue_ ...
- RabbitMQ消息队列服务
MQ 全称为 Message Queue, 消息队列( MQ ) 是一种应用程序对应用程序的通信方法.应用程序通过读写出入队列的消息(针对应用程序的数据)来通信,而无需专用连接来链接它们. 一个软件它 ...
- Docker初探之运行RabbitMQ消息队列服务
我们平时在使用RabbitMQ是基于Windows操作系统的,在使用前需要安装Er-Lang和RabbitMQ服务程序,如果版本不对RabbitMQ就启动失败,安装流程也比较麻烦. 但如果在Docke ...
- golang监听rabbitmq消息队列任务断线自动重连接
需求背景: goalng常驻内存任务脚本监听rbmq执行任务 任务脚本由supervisor来管理 当rabbitmq长时间断开连接会出现如下图 进程处于fatal状态 假如因为不可抗拒因素,rabb ...
- RabbitMQ消息队列(四)-服务详细配置与日常监控管理
RabbitMQ服务管理 启动服务:rabbitmq-server -detached[ /usr/local/rabbitmq/sbin/rabbitmq-server -detached ] 查看 ...
- RabbitMQ消息队列(一): Detailed Introduction 详细介绍
http://blog.csdn.net/anzhsoft/article/details/19563091 RabbitMQ消息队列(一): Detailed Introduction 详细介绍 ...
- RabbitMQ消息队列1: Detailed Introduction 详细介绍
1. 历史 RabbitMQ是一个由erlang开发的AMQP(Advanced Message Queue )的开源实现.AMQP 的出现其实也是应了广大人民群众的需求,虽然在同步消息通讯的世界里有 ...
- Net分布式系统之四:RabbitMQ消息队列应用
消息通信组件Net分布式系统的核心中间件之一,应用与系统高并发,各个组件之间解耦的依赖的场景.本框架采用消息队列中间件主要应用于两方面:一是解决部分高并发的业务处理:二是通过消息队列传输系统日志.目前 ...
随机推荐
- RocketMQ(二):RPC通讯
匠心零度 转载请注明原创出处,谢谢! RocketMQ网络部署图 NameServer:在系统中是做命名服务,更新和发现 broker服务. Broker-Master:broker 消息主机服务器. ...
- docker安装+测试环境的搭建---
漏洞演练环境docker地址:http://vulhub.org/#/environments/ 环境:kali-linux-2017.2-amd64.iso 一.docker安装 1.先更新一波源: ...
- Mego开发文档 - 快速概述
Mego 快速概述 Mego 是一款轻量级,可扩展和跨平台的数据访问技术. Mego 是一个对象关系映射器(O / RM),它使.NET开发人员能够使用.NET对象处理数据库.它消除了开发人员通常需要 ...
- Java Jar包压缩、解压使用指南
什么是jar包 JAR(Java Archive)是Java的归档文件,它是一种与平台无关的文件格式,它允许将许多文件组合成一个压缩文件. 如何打/解包 使用jdk/bin/jar.exe工具,配置完 ...
- linux环境 安装chromedriver 和 phantomjs的方法
1 首先要下载浏览器驱动: 常用的是chromedriver 和phantomjs chromedirver下载地址: https://npm.taobao.org/mirrors/chromedri ...
- CentOS7配置php7.0支持redis
配置之前应该是环境已经搭好了,phpinfo的页面可以加载出来. 使用git clone下载git上的phpredis扩展包 [root@VM_103_117_centos ]#git clone ...
- 使用SQL语句在SQL server2017上创建数据库
软件基础:在电脑上提前安装好SQL server2017,并且安装好其中的SSMS(SQL server Management Studio) 创建方式:SQL语句 操作内容:创建零件供应数据库系统 ...
- SQL语句 (一)
1 SQL语句分类: 数据查询语句(DQL): SELECT 数据操纵语言 (DML): INSERT.UPDATE.DELETE 数据定义语言 (DDL): 数据控制语言 (DCL): GRANT. ...
- java基本数据类型的包装类
基本类型对应的包装类 byte(Byte).short(Short).int(Integer).long(Long).float(Float).double(Double).char(Characte ...
- 0417 jQuery基础知识
jQuery基础知识 jQuery需要引入一个js文件,并且这个文件在所有js代码之前(包括引入的其他js文件) 基础操作(对比js): 1.找标签: js:document.getElement.. ...