Azure service bus Topic基本用法

我们在升级一个POS系统的时候，决定使用微软公有云计算平台下的Azure ServiceBus 进行POS客户端与服务器的交互。

本文主要时作者在学习使用 Azure SDK for .NET 操作由世纪互联运营的 中国区Azure 上的 Service Bus。

---

 

目录
一、安装AzureServiceBus程序集

二、在Portal创建命名空间

三、通过代码创建Topic

四、通过代码创建订阅

五、创建并发送消息

六、消费消息

---

  

1.通过nuget安装程序集

using Microsoft.ServiceBus;
using Microsoft.ServiceBus.Messaging;

using Microsoft.Azure;

2. 在Portal创建 service bus 命名空间：

 

只有标准级别可以使用主题（Topic），因此创建命名空间时，请选择标准；

也可以创建后，在缩放选项卡里调整为标准。

 

3.创建主题，可以通过portal创建，也可以通过代码创建：

 

 通过代码创建主题：

// Create the topic if it does not exist already.
            string connectionString =
                CloudConfigurationManager.GetSetting("Microsoft.ServiceBus.ConnectionString");

            var namespaceManager =
                NamespaceManager.CreateFromConnectionString(connectionString);

            if (!namespaceManager.TopicExists("TestTopic"))
            {

                //默认的createtopic方法
                 namespaceManager.CreateTopic("TestTopic");


                // 通过TopicDescription构建一个重载
                //TopicDescription td = new TopicDescription("TestTopicCustomer");
                //td.MaxSizeInMegabytes = 5120;
                //td.DefaultMessageTimeToLive = new TimeSpan(0, 1, 0);
                //if (!namespaceManager.TopicExists("TestTopicCustomer"))
                //{
                //    namespaceManager.CreateTopic(td);
                //}

            }

 

4.创建订阅：

下面的代码演示创建了三个订阅，其中Product和Customer订阅增加了一个SqlFilter，即如果发送消息时，

 message.Properties["Entity"] = "Product"，则消息会由Product订阅处理；

 message.Properties["Entity"] = "Customer"，则消息会由Customer订阅处理；

 string connectionString =
    CloudConfigurationManager.GetSetting("Microsoft.ServiceBus.ConnectionString");

            var namespaceManager =
                NamespaceManager.CreateFromConnectionString(connectionString);

            if (!namespaceManager.SubscriptionExists("TestTopic", "AllMessages"))
            {
                namespaceManager.CreateSubscription("TestTopic", "AllMessages");
            }

            Console.WriteLine("AllMessages done");


            // Create a "ProductMessagesFilter" filtered subscription.
            SqlFilter ProductMessagesFilter =
               new SqlFilter("Entity='Product'");

            namespaceManager.CreateSubscription("TestTopic",
               "Product",
               ProductMessagesFilter);

            Console.WriteLine("Product done");

            // Create a "CustomerMessagesFilter" filtered subscription.
            SqlFilter CustomerMessagesFilter =
               new SqlFilter("Entity='Customer'");

            namespaceManager.CreateSubscription("TestTopic",
               "Customer",
               CustomerMessagesFilter);

            Console.WriteLine("Customers done");

 

5.创建并发送普通消息：

下面创建了5个product和3个customer并发送了消息，

 BrokeredMessage message = new BrokeredMessage(product);

 BrokeredMessage message = new BrokeredMessage(customer);

Product有如下设置：message.Properties["Entity"] = "Product";

Customer有如下设置：message.Properties["Entity"] = "Customer";

则 product 订阅会有5条消息，customer订阅会有3条消息，另外，Allmessages没有任何sqlfilter，则该订阅会有5+3=8条消息。

 string connectionString =
    CloudConfigurationManager.GetSetting("Microsoft.ServiceBus.ConnectionString");

            TopicClient Client =
                TopicClient.CreateFromConnectionString(connectionString, "TestTopic");

           // Client.Send(new BrokeredMessage());


            //Add 5 Products
            var product = new Model.Product();

            for (int i = 0; i < 5; i++)
            {

                product.ProductID ="ProductID"+ i.ToString();

                // Create message, passing a Product  for the body.
                BrokeredMessage message = new BrokeredMessage(product);

                // Set additional custom app-specific property.
                message.Properties["Entity"] = "Product";

                //ScheduledMessage
                //message.ScheduledEnqueueTimeUtc = DateTime.Now.AddMinutes(1);

                // Send message to the topic.
                Client.Send(message);
            }


            //Add 3 Customers
            var customer = new Model.Customer();

            for (int i = 0; i < 3; i++)
            {

                customer.CustomerID = "CustomerID"+i.ToString();

                // Create message, passing a Customer message for the body.
                BrokeredMessage message = new BrokeredMessage(customer);

                // Set additional custom app-specific property.
                message.Properties["Entity"] = "Customer";

                // Send message to the topic.
                Client.Send(message);
            }

发送消息后的效果：

 创建定时消息：

设置消息的如下属性，则消息在发送成功后延时1分钟后才会出现在上图中，也才可以被订阅消费。

message.ScheduledEnqueueTimeUtc = DateTime.Now.AddMinutes(1);

6.消费消息：

不同的订阅可以取不同订阅里的消息进行处理，处理完成后，标记message.Complete()即可从订阅里清除消息。

string connectionString =
    CloudConfigurationManager.GetSetting("Microsoft.ServiceBus.ConnectionString");

            //SubscriptionClient Client =
            //    SubscriptionClient.CreateFromConnectionString
            //            (connectionString, "TestTopic", "Customer");

            //SubscriptionClient Client =
            //   SubscriptionClient.CreateFromConnectionString
            //           (connectionString, "TestTopic", "Product");

            SubscriptionClient Client =
              SubscriptionClient.CreateFromConnectionString
                      (connectionString, "TestTopic", "AllMessages");

            // Configure the callback options.
            OnMessageOptions options = new OnMessageOptions();
            options.AutoComplete = false;
            options.AutoRenewTimeout = TimeSpan.FromMinutes(1);

            Client.OnMessage((message) =>
            {
                try
                {
                    // Process message from subscription.
                    Console.WriteLine("Messages");
               
                    Console.WriteLine("MessageID: " + message.MessageId);
                    Console.WriteLine("Message EntityType=: " +
                        message.Properties["Entity"]);


                    if(message.Properties["Entity"].ToString()=="Customer")
                    {
                        Console.WriteLine("CustomerID=" + message.GetBody<Customer>().CustomerID.ToString());
                    }
                    if (message.Properties["Entity"].ToString() == "Product")
                    {
                        Console.WriteLine("ProductID=" + message.GetBody<Product>().ProductID.ToString());
                    }

                    

                    // Remove message from subscription.
                    message.Complete();
                }
                catch (Exception)
                {
                    // Indicates a problem, unlock message in subscription.
                    message.Abandon();
                }
            }, options);

            Console.ReadLine();

 

特别注意：消费掉Product或Customer里的消息后，AllMessage里的消息不受影响。