首页 > 代码库 > Github开源:Sheng.RabbitMQ.CommandExecuter (RabbitMQ 的命令模式实现)
Github开源:Sheng.RabbitMQ.CommandExecuter (RabbitMQ 的命令模式实现)
[Github]:https://github.com/iccb1013/Sheng.RabbitMQ.CommandExecuter
Sheng.RabbitMQ.CommandExecuter 是使用 .Net 对 RabbitMQ 的一个简单封装。
它通过XML配置文件定义Exchange及队列等信息,根据此配置文件自动声明及初始化相关队列信息,方便 .Net 开发人员使用 RabbitMQ。
并实现了一个基于 MQ 的命令执行器,将 MQ 消息抽象化为命令,发布端和订阅端通过命令进行交互。默认实现了两个命令:
1)HTTP请求转发,将收到的MQ消息的指定内容转发到指定URL上;
2)数据库同步,通过预先定义的配置文件,指明不同数据库和表之间的关联关系,发送端向 MQ 中发布数据库同步命令后,订阅方(可作为 windows 服务部署,已在工程中实现)负责解析并执行数据库同步工作。
你可以直接使用基本的 RabbitMQ 封装,也可以在此命令模式的基础上实现你自己的命令。
Sheng.RabbitMQ.CommandExecuter.Contract:命令模式中的命令契约,命令的发布方和接收方通过此契约类库共享已知类型。
Sheng.RabbitMQ.CommandExecuter.Core:命令模式的核心实现,命令的解释和执行在此实现,并默认实现了两个命令。
Sheng.RabbitMQ.CommandExecuter.RabbitMQ:RabbitMQ 的简单封装,通过XML配置文件初始化 RabbitMQ,可单独使用此工程方便在 .Net 工程中使用 RabbitMQ。
Sheng.RabbitMQ.CommandExecuter.Service:Windows 服务,可做为命令模式中的接收端。
Sheng.RabbitMQ.CommandExecuter.WindowsForm:没有实际功能,方便开发阶段调试程序。
RabbitMQConfig.xml 用于配置 RabbitMQ 信关信息:
<?xml version="1.0" encoding="utf-8" ?><rabbitMQ> <connectionFactory hostName="192.168.100.100" userName="user" password="1234"></connectionFactory> <exchangeList> <exchange name="exchangeName_A" type="direct"> <queueList> <queue name="queue_test_A" durable="true" exclusive="false" autoDelete="false" routingKey="routingKey_A" type="send"></queue> <queue name="queue_test_B" durable="true" exclusive="false" autoDelete="false" routingKey="routingKey_B" type="receive"></queue> </queueList> </exchange> </exchangeList></rabbitMQ>
相关属性与 RabbitMQ 名称意义皆相同,只是注意一点,queue 节点中的 type 有 send 和 receive 两种,send 表示此队列只用于发送消息,receive 表示此队列只用于接收消息。RabbitMQService 不会订阅 type 为 send 的队列的消息。
代码简要说明:
声明核心类:RabbitMQService ,然后通过此类订阅消息,发送消息。
RabbitMQService _rabbitMQService = RabbitMQService.Instance;
通过 Subscribe 方法订阅消息:
private void btnStartService_Click(object sender, EventArgs e) { _rabbitMQService.Subscribe("routingKey_B", RabbitMQCallback); _rabbitMQService.Start(); MessageBox.Show("RabbitMQService 已启动。"); } private void RabbitMQCallback(ulong deliveryTag, string routingKey, string body) { _rabbitMQService.Ack(deliveryTag, false); Debug.WriteLine(routingKey + Environment.NewLine + body); MessageBox.Show(routingKey + Environment.NewLine + body); }
_rabbitMQService.Start() 用于启动 RabbitMQ 的监听。
通过 Send 方法发送消息:
_rabbitMQService.Send("exchangeName_A", "routingKey_B", "123");
有关命令模式的实现说明:
在契约类库中,所有的命令均继承自 Command 类,并提供一个 CommandType 属性
public abstract class Command { public string CommandType { get; protected set; } }
简单的 URL 转发命令的定义如下:
public class DatabaseSyncForwardCommand: Command { public const string CommandTypeName = "DatabaseSyncForwardCommand"; public DatabaseSyncForwardCommand() { base.CommandType = CommandTypeName; } public string Url { get;set; } public string CommandContent { get;set; } }
命令的解析和执行在 Sheng.RabbitMQ.CommandExecuter.Core 中
CommandExecuterService 用于向调用者提供命令执行服务的整体封装,通过它启动命令的监听和执行。
CommandReceiver 目录下是命令的接收和执行程序,每个命令都有一个对应的 *Receiver 类,这些类通过 CommandReceiverFactory 这个工厂类统一实例化和调用。
有关数据库同步命令的说明
数据库同步命令可以实现简单的,多个数据库之间的表数据同步。可以定义多个消费者,并为每个消费者定义多个数据提供者,并定义它们之间的表结构对应关系。在文件 DatabaseSyncConfig.xml 中定义:
<?xml version="1.0" encoding="utf-8" ?><databaseSync> <connectionList> <connection name="connection1" connectionString=""/> <connection name="connection2" connectionString=""/> </connectionList> <consumerList> <consumer name="crm" connection="connection1"> <producerList> <producer name="erp" routingKey="routingKey_A" connection="connection2"> <tableDefinition> <table name="Customers" primaryKey="Id" consumerTable="Customers" consumerTablePrimaryKey="Id"> <Field name="Id" consumerField="Id" ></Field> <Field name="CustomerName" consumerField="CustomerName"></Field> <Field name="NopUserName" consumerField="NopUserName"></Field> </table> </tableDefinition> </producer> </producerList> </consumer> </consumerList></databaseSync>
connectionList 节点用于定义数据库连接,可以定义多个不同的数据库连接,并在下面的配置环节中引用。
consumerList 用于配置消费者,consumer 下的 producer 表示针对这一消费者的数据提供者。
tableDefinition 用于定义消费者和数据提供者之间的表结构对应关系。
相关程序在收到数据库同步命令时,通过数据提供者定义中的 routingKey 来判断数据同步命令来自哪个数据提供者。
对于数据的提供者,通过类似如下代码,向 MQ 中发送数据同步命令:
DatabaseSyncCommand cmd = new DatabaseSyncCommand(); DatabaseSyncItem item1 = new DatabaseSyncItem(){ Action = DatabaseSyncAction.Add, Table = "Customers", PrimaryKeyValue = "062B54F5-69AA-A108-09F8-39DB9C2F58C4"}; cmd.SyncItemList.Add(item1); string json = JsonConvert.SerializeObject(cmd); _rabbitMQService.Send("exchangeName_A", "routingKey_A", json);
以上。
QQ: 279060597 @南京
引用请注明原文出处: http://sheng.city/post/sheng-rabbitmq-commandexecuter
Github开源:Sheng.RabbitMQ.CommandExecuter (RabbitMQ 的命令模式实现)