【EasyNetQ笔记】连接
连接
//创建连接
var bus = RabbitHutch.CreateBus(“host=myServer;virtualHost=myVirtualHost;username=mike;password=topsecret”);
//关闭连接
bus.Dispose();
连接字符串说明
- host(例如 host=192.168.2.56)这个字段是必选的。如要具体指定你要连接服务器端口,你用标准格式 host:port(例如:host=myhost.com:5673)。假如你省略了端口号,AMQP默认端口是5672.连接到RabbitMQ集群,需要指定每一个集群节点用逗号分隔(例如:host:myhost1.com,myhost2.com,myhost3.com)
- virtualhost(例如:virtualHost=myVirturalHost)默认虚拟主机是’/’
- username(例如:username=mike)默认是’guest’(对于非’localhost’主机你需要使用其他用户名)
- password (例如:password=mysecret)默认为’guest’
- requestedHearbeat(例如:requestHearbeat=10)默认为10秒钟。没有心跳设置为0
- prefetchcount(例如:prefetchcount=1) 默认为50.这个值是在EasyNetQ发送ack之前发送给RabbitMQ的消息数。不限制设置为0(不推荐). 为了在消费者之间保持公平和平衡设置为1.
- publisherConfirms 默认是false。publisherConfirms是指发布确认,当值为true时,发布者需要确认消息发送到消息队列成功,发送成功取决于以下几种情况:
- 非持久化消息入队后会被确认
- 持久化消息被持久化到硬盘会被确认
- 一条无法路由的非持久化消息直接被确认
- persistentMessages(例如:
persistentMessages=false
)默认为true
。这个决定了在发送消息时采用什么样的delivery_mode
。 false=1,true=2. 设置为true,RabbitMQ将会把消息持久化到磁盘,并且在服务器重启后仍会存在。设置为false可以提高性能收益。 - product(例如:product=我的现实中重要的服务)在EasyNetQ 0.27.3中被引进。默认值是Bus的实例名。此处输入的值将显示在RabbitMQ的后台管理界面中。
- platform(例如:platform=my.fully.qualified.domain.name)在EasyNetQ 0.27.3中被引进。默认值是运行着客户端处理Bus的实例的机器的主机名。此处输入的值将会线上在RabbitMQ管理端界面中。
- timeout(例如:timeout=60)模式值为10秒。同步bus.Publish(..)方法将在返回之前等待确认,发布确认超时时间,0到65535范围内的值。不限制超时时间设置为0.当超时事时抛出System.TimeoutException.
发布确认
同步bus.Publish(..)方法将在返回之前等待确认。在超时期限(连接字符串timeout)之前未确认将导致抛出异常。随着发布者确认同步发布方法将显着减慢。
如果需要考虑性能,则应考虑使用PublishAsync方法:
bus.PublishAsync(new MyMessage
{
Text = "Hello World"
}).ContinueWith(task =>
{
// this only checks that the task finished
// IsCompleted will be true even for tasks in a faulted state
// we use if (task.IsCompleted && !task.IsFaulted) to check for success
if (task.IsCompleted && !task.IsFaulted)
{
//Console.Out.WriteLine("{0} Completed", count);
}
if (task.IsFaulted)
{
Console.Out.WriteLine("\n\n");
Console.Out.WriteLine(task.Exception);
Console.Out.WriteLine("\n\n");
}
});
SSL连接
var connection = new ConnectionConfiguration();
connection.Port = 443;
connection.UserName = "user";
connection.Password = "pass";
connection.Product = "SSLTest";
var host1 = new HostConfiguration();
host1.Host = "rmq1.contoso.com";
host1.Port = 443;
host1.Ssl.Enabled = true;
host1.Ssl.ServerName = "rmq1.contoso.com";
host1.Ssl.CertPath = "c:\\tmp\\myclient.p12";
host1.Ssl.CertPassphrase = "secret";
var host2 = new HostConfiguration();
host2.Host = "rmq2.contoso.com";
host2.Port = 443;
host2.Ssl.Enabled = true;
host2.Ssl.ServerName = "rmq2.contoso.com";
host2.Ssl.CertPath = "c:\\tmp\\myclient.p12";
host2.Ssl.CertPassphrase = "secret";
connection.Hosts = new List<HostConfiguration> { host1, host2 };
connection.Validate(); //VERY IMPORTANT - DOES CONFIG AS WELL AS VALIDATION!
var Bus = RabbitHutch.CreateBus(connection, services => services.Register<IEasyNetQLogger>(logger => new DoNothingLogger()));
在HostConfiguration对象上设置SSL选项可启用对群集方案的支持。请注意,在上面的示例中,我们指定了两个HostConfiguration对象。如果一个不可用,EasyNetQ的PersistentConnection功能将自动连接到下一个可用主机。在主机上配置SSL设置将允许它连接而没有任何错误。
如果只指定一个主机,则可以选择直接在HostConfiguration对象或ConnectionConfiguration对象上设置SslOptions。
不要忘记调用Validate()。我最初跳过了(基于我对所有内容进行了硬编码,因此可能没有任何错误需要验证)。但是,该方法调用实际上应用了使连接工作所需的各种设置。
集群支持
EasyNetQ支持RabbitMQ群集,无需部署负载均衡器。
只需在连接字符串中列出群集的节点...
var bus = RabbitHutch.CreateBus("host=ubuntu:5672,ubuntu:5673");
在这个例子中,我们在一台机器上建立了一个集群'ubuntu',端口5672上的节点1和端口5673上的节点2上。当CreateBus
语句执行时,EasyNetQ将尝试连接到列出的第一台主机(ubuntu:5672)。 如果连接失败,它会尝试连接到列出的第二台主机(ubuntu:5673)。 如果两个节点都不可用,则它将位于重试循环中,每五秒钟尝试连接两台服务器。 它将所有这些活动记录到注册的IEasyNetQLogger
。 如果第一个节点不可用,您可能会看到类似这样的内容:
DEBUG: Trying to connect
ERROR: Failed to connect to Broker: 'ubuntu', Port: 5672 VHost: '/'. ExceptionMessage: 'None of the specified endpoints were reachable'
DEBUG: OnConnected event fired
INFO: Connected to RabbitMQ. Broker: 'ubuntu', Port: 5674, VHost: '/'
如果EasyNetQ连接的节点发生故障,EasyNetQ将尝试连接到下一个列出的节点。 一旦连接,它将重新申报所有交易所和队列,并重新启动所有消费者。 以下是一个示例日志记录,显示一个节点出现故障,然后EasyNetQ连接到另一个节点并重新创建订户:
INFO: Disconnected from RabbitMQ Broker
DEBUG: Trying to connect
DEBUG: OnConnected event fired
DEBUG: Re-creating subscribers
INFO: Connected to RabbitMQ. Broker: 'ubuntu', Port: 5674, VHost: '/'
1,随机主机选择
如果您有多个使用EasyNetQ连接到RabbitMQ群集的服务,它们将首先连接到其各自连接字符串中的第一个列出的节点。 如果您打算使用负载平衡功能,则应考虑切换到RandomClusterHostSelectionStrategy
。 像这样配置它:
var bus = RabbitHutch.CreateBus("host=myfirsthost,mysecondhost", x => x.Register<IClusterHostSelectionStrategy<ConnectionFactoryInfo>, RandomClusterHostSelectionStrategy<ConnectionFactoryInfo>>());
在这个片段中,我们已经替换了RandomClusterHostSelectionStrategy
的默认IClusterHostSelectionStrategy
,它将随机选择主机。 您可以在这里找到更多有关替换EasyNetQ组件的信息。
2,考虑使用专用的负载平衡器
EasyNetQ集群支持的替代方案是使用专用的前端代理。 有关详细信息,请参阅RabbitMQ集群指南的结尾:http://www.rabbitmq.com/clustering.html