.Net下RabbitMQ的使用(9) -- 在WCF下使用RabbitMQ

 

RabbitMQ .net客户端通过自定义的Binding和Transport Binding Element扩展了WCF，使之能够在AMQP协议上使用。在WCF中，Binding作为一系列Binding Elements的栈，控制了消息传输的大部分方面如安全，消息格式，事务等等。而Binding中的Transport Binding Element传输绑定元素，则指定了服务端和客户端之间的通信协议。RabbitMQ .net客户端提供的Binding使我们可以在AMQP协议上面使用WCF方便的实现One-Way， Two-Way（Request/Reply），Duplex（Asynchronous Callback）这样的常见通信方式，并且提供可靠的，事务性的传输。我们可以通过代码和传统WCF配置文件的方式进行开发。

 

WCF的ABC

Address

使用RabbitMQ Binding 的地址一定要使用如下格式：serviceAddress = “soap.amqp:///” serviceName，例如：soap.amqp:///myService。它使用类型是direct的exchange。其他类型的exchange似乎不被支持。

需要注意的是，用IIS来作为Host是不被推荐的，应该使用System.ServiceModel.ServiceHost来Host，RabbitMQ的服务端。地址的配置可以通过代码也同样可以通过config文件来配置。

 

Binding

RabbitMQ使用的Binding不是在.net客户端RabbitMQ.Client中提供，而是在RabbitMQ.ServiceModel.dll这个新的dll中提供。可以再官方网站或者Nuget中获取到。所以在引用RabbitMQ.Client.dll的同时还要引用RabbitMQ.ServiceModel.dll。在配置文件中定义时，必须要配置Binding的extension。

我们在配置文件中如下配置：

<bindings>
      <rabbitMQBinding>
        <binding name="rabbitMQConfig"
         protocolversion="AMQP_0_9_1"
                 hostname="localhost"
                 port="5672" />
      </rabbitMQBinding>
    </bindings>
    <extensions>
      <bindingExtensions>
        <add
          name="rabbitMQBinding"
          type="RabbitMQ.ServiceModel.RabbitMQBindingSection, RabbitMQ.ServiceModel, Version=1.0.110.0, Culture=neutral, PublicKeyToken=null"/>
      </bindingExtensions>
    </extensions>

 

关于RabbitMQ.ServiceModel.dll中Binding的相关详细信息，默认使用和可以使用的绑定元素可以参考官方提供的文档。

 

Contract

Contract的定义是和原来的WCF定义是一样的，没有什么区别，加上ServiceContractAttribute和OperationContractAttribute属性就可以：

[ServiceContract]
public interface ICalculator
{
    [OperationContract]
    int Add(int x, int y);
    [OperationContract]
    int Subtract(int x, int y);
}

如果要在具体服务的实现上使用Behavior也可原来一样：

[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerCall)]
public sealed class Calculator : ICalculator
{
    public int Add(int x, int y)
    {
        return x + y;
    }
    public int Subtract(int x, int y)
    {
        return x - y;
    }
}

 

服务

服务的定义也和常用的WCF定义一样，配置文件定义和代码定义。Host应该使用System.ServiceModel.ServiceHost。ServiceHost必须定义一个基地址或者是完整的Endpoint地址，该地址是用soap.amqp格式的。Endpoint必须添加使用RabbitMQBinding。

service = new ServiceHost(
    typeof(Calculator),
    new Uri("soap.amqp:///"));
service.AddServiceEndpoint(
typeof(ICalculator),
new RabbitMQBinding(
"localhost",
5672,
"guest",
"guest",
"/",
8192,
Protocols.AMQP_0_9_1),
"Calculator");

 

服务端完整的配置文件定义如下：

<system.serviceModel>
    <services>
      <service name="ESBTest.WcfRabbitMQ.ConsoleServerPerformance.RabbitMQServer">
        <host>
          <baseAddresses>
            <add baseAddress="soap.amqp:///"   />
          </baseAddresses>
        </host>
        <endpoint
          address="ESBTest.WcfRabbitMQ.ConsoleServerPerformance"
          binding="rabbitMQBinding"
          bindingConfiguration="rabbitMQConfig"
          contract="ESBTest.Contracts.IRequest"/>
      </service>
    </services>

    <bindings>
      <rabbitMQBinding>
        <binding name="rabbitMQConfig"
                 hostname="localhost"
                 port="5672"
                 protocolversion="AMQP_0_9_1"
                 oneWay="false"/>
      </rabbitMQBinding>
    </bindings>

    <extensions>
      <bindingExtensions>
        <add
          name="rabbitMQBinding"
          type="RabbitMQ.ServiceModel.RabbitMQBindingSection, RabbitMQ.ServiceModel, Version=1.0.110.0, Culture=neutral, PublicKeyToken=null"/>
      </bindingExtensions>
    </extensions>
  </system.serviceModel>

 

开多个服务端，同样可以实现负载均衡。

 

客户端

客户端的定义也和常用的WCF定义一样，官方推荐通过继承自ClientBase<T>或DuplexClientBase<T>来实现。如果是Duplex的客户端，InstanceContext必须要指定的。

完整的客户端配置文件定义如下：

<system.serviceModel>
    <client>
      <endpoint address="soap.amqp:///ESBTest.WcfRabbitMQ.ConsoleServerPerformance"
                binding="rabbitMQBinding"
                bindingConfiguration="rabbitMQConfig"
                contract="ESBTest.Contracts.IRequest"
                name="client" />
    </client>
    <bindings>
      <rabbitMQBinding>
        <binding name="rabbitMQConfig"
         protocolversion="AMQP_0_9_1"
                 hostname="localhost"
                 port="5672" />
      </rabbitMQBinding>
    </bindings>
    <extensions>
      <bindingExtensions>
        <add
          name="rabbitMQBinding"
          type="RabbitMQ.ServiceModel.RabbitMQBindingSection, RabbitMQ.ServiceModel, Version=1.0.110.0, Culture=neutral, PublicKeyToken=null"/>
      </bindingExtensions>
    </extensions>
  </system.serviceModel>

 

我们可以看到，提供的WCF Binding只是一些简单通用的功能，RabbitMQ的一些其他比较好的功能并没有提供。所以使用WCF或者直接使用客户端要视业务和系统环境而定，如果只是使用一些简单的功能或整个系统都是基于WCF的，那么使用WCF来做RabbitMQ，会给你提供一个快速的，一致性的开发模型。但如果使用的场景比较复杂，性能要求比较高的话还是使用.net客户端的API比较理想。直接使用客户端API和WCF来比较，就速度而言，WCF花的是时间大概是直接使用API的7倍左右，慢得多。这点相信大家也是可以预见的。

 

简单代码示例在这里下载。是One-Way的。