在【Azure Services Platform Step by Step-第9篇】Windows Azure Storage概览中，我们已经讨论过Table Storage的作用和特点。本篇将以搭建简单的聊天室为例，演示如果使用最简单的代码，将C#实体类(Entity)直接存入Table Storage中，彻底告别SQL Server 200x和ORM工具。

最终效果： (已部署到云端的Demo :http://ibm.cloudapp.net/ChatMain.aspx)

 

首先让我们一起回顾一下Table Storage的结构。

每行都是一个独立的Entity。

Partition Key和RowKey起到了类似于主键的作用，它们用来标识Entity，同时也可以在实际使用中作为分类查询条件。

TimeStamp属性(上图没画出)是每行都默认有的，它自动记录该行数据最后更新的时间。

 

接下来我们来看看StorageClient中是怎样使用TableStorage的

 

看着这图，单看文件名，觉得很奇怪吧？ Blob和Queue都使用了Rest来实现，唯独Table没有一个对应REST的类。那它是怎么做的呢？

查看源代码可以发现，原来，它使用的是System.Data.Services.Client里的DataServiceQuery和DataServiceContext这两个ADO.NET 数据服务的关键类来实现的。拿TableStorageDataServiceContext类来说，它继承自DataServiceContext，或者说，它把DataServiceContext封装成了Azure版！

（对ADO.NET数据服务Client不了解的朋友请查阅http://msdn.microsoft.com/zh-cn/library/system.data.services.client.dataservicecontext.aspx）

呵呵，不管怎么样，我们使用方便就好了。

了解完了原理，我们来进入正题吧。

 

第一步：

在VS008中新建Web Cloud Service、配置ServiceConfiguration.cscfg、ServiceDefinition.csdef ，添加对StorageClient项目的引用。这里不再重复了，请直接参考上一篇的内容或者本文篇末附件源代码。

直接使用上一节里的ServiceConfiguration.cscfg和ServiceDefinition.csdef也行，因为账户信息是一样的。

 

 

第二步：

拖入控件，制作简单的登录界面和主聊天界面。这不是重点也不是难点，请大家直接参看本文篇末附件源代码。其实聊天室和留言吧的区别不大，使用ASP.NET Ajax的Timer和UpdatePanel让它每两秒刷新一次就行。

 

 

 

 

第三步：

建立一个Message实体类。

与传统代码或由ORM工具生成的实体代码不同，它需要继承自TableStorageEntity.

 

 

第四步：

建立一个MessageDataServiceContext实体类。该类继承自TableStorageDataServiceContext，也就是间接继承自DataServiceContext。它的作用是获得一个对数据服务上下文的引用。此外，定义一个公共属性Messages：可返回所有Message类型实体； 增加AddMessage方法：将Message实体存入Table Storage。

 

 

第五步：

取实体:

 

 

存入实体:

 

 

OK,搞定了!

F5一下看看运行效果吧！

 

            ______————————____忐忑不安的分割线______————————______

通过REST方法获得实体的真实相貌：

可以清楚地看到，这个实体有5个属性。其中有3个是默认必须有的属性，只有Body和Name是我们在实体类里自己定义的。

 

【附件】

传说中的StorageClient:StorageClient.rar

本篇源代码：AzureChatRoom.rar (已与前面章节的源代码整合)

在第9篇里，为了便于大家理解，我把Windows Azure的环境比喻成了"Azure兰州拉面馆"。本篇我们继续沿用这个比喻，讲讲Windows Azure中的队列(Queue Storage)与日志的使用。

 

Queue Storage在【Azure Services Platform Step by Step-第9篇】Windows Azure Storage概览里介绍过，这里就不再重复了。顾名思义，Queue就是队列，按照先进先出的顺序来处理数据。在上图的“Azure兰州拉面馆”中，Queue就充当了记录点菜情况的小本子，前台服务员将顾客点的菜记录在Queue中，后台厨房的厨师则按照Queue中的顺序，一个一个地做菜（处理数据）。

Windows Azure Log是整个Azure平台运行情况的日志。微软官方把Windows Azure比喻成“云平台的操作系统”，既然是操作系统，当然会维护日志了！Windows Azure里提供了非常简单记录日志的办法，但很遗憾地是没有提供同样简单地查看日志的办法——换句话说，通过程序记录日志容易，查看日志繁琐。为了不偏题，本篇只展示如何在Development Fabric里查看日志。对于如何编程读取日志，感兴趣的读者可以参考WPF应用程序AzureLogViewer的源代码(见篇末附件）。

 

实验步骤：

 

第一步：

在VS2008中新建Web And Worker Cloud Service。这也是本系列文章中第一次用到Worker Role。

与第9篇一样，添加对StorageClient的引用。

 

第二步：

运行Azure SDK里的 和 ，并启动Development Storage里的Queue服务。

 

第三步：

配置好ServiceConfiguration.cscfg和ServiceDefinition.csdef。如有疑问，请参考【Azure Services Platform Step by Step-第8篇】开发部署Azure留言板或本文篇末附件内的示例代码。

 

 

第四步：

打开Web Role项目的Default.aspx，拖入以下控件：

TextBox txtMessage

Button btnSend

TextBox txtLog

第五步：

在Button btnSend的Click中加入btnSend_Click。代码如下。

protected void btnSend_Click(object sender, EventArgs e)
{
//读取Queue服务的配置。注意：RoleManager.GetConfigurationSetting获取的是  

//service configuration(即ServiceConfiguration.cscfg文件)里的配置。
Uri baseUri = new Uri(RoleManager.GetConfigurationSetting("QueueEndpoint"));
string accountName = RoleManager.GetConfigurationSetting("AccountName");
string accountKey = RoleManager.GetConfigurationSetting("AccountSharedKey");
//初始化StorageAccountInfo实体。
StorageAccountInfo account = new StorageAccountInfo(
baseUri,
null,
accountName,
accountKey);
//创建一个QueueStorage(即Queue Storage服务)的实体
QueueStorage service = QueueStorage.Create(account);
//创建一个MessageQueue(即队列)的实体。
//这个queue就是咱们Azure拉面馆的“记菜本”了
//我们把这个记菜本取名为"message"。
MessageQueue queue = service.GetQueue("messages");
//判断当前Queue Storage服务中是否已经存在"message"
if (!queue.DoesQueueExist())
{
queue.CreateQueue();
}
//把点菜信息记录到记菜本中！
Message msg = new Message(txtMessage.Text);
queue.PutMessage(msg);
txtLog.Text += "\n你在"+DateTime.Now.ToString("HH点mm分ss秒")+"点了一份\"" + txtMessage.Text.Trim()+'\"';
txtMessage.Text = string.Empty;
}

最关键的就是一步：queue.PutMessage(msg); 就这样很轻松地把消息存入队列了。

第六步：

打开WorkerRole项目里的WorkerRole.cs。我们首先要对Start()进行override 。

Start()函数可以理解为Worker Role的入口函数。一旦Worker Role被部署，就会触发Start()。

我们讨论过，Worker Role的牛X之处就是可以让一段程序一直在运行。如何做到呢？只需把Start()方法写成一个死循环方法就好了。

public override void Start()
{
// 初始化账户信息
Uri baseUri = new Uri(RoleManager.GetConfigurationSetting("QueueEndpoint"));
string accountName = RoleManager.GetConfigurationSetting("AccountName");
string accountKey = RoleManager.GetConfigurationSetting("AccountSharedKey");
StorageAccountInfo account = new StorageAccountInfo(
baseUri,
null,
accountName,
accountKey);
           QueueStorage service = QueueStorage.Create(account);

           // 取得对这个名叫＂message＂的记菜本Queue的引用
MessageQueue queue = service.GetQueue("messages");
// 构造死循环

           while (true)
{

              // 死循环中的程序每一秒执行一次

               Thread.Sleep(10000);
if (queue.DoesQueueExist())
{

                  // 取得记菜本中的当前应该处理的消息

                   Message msg = queue.GetMessage();
if (msg != null)
{

                     // 记录Windows Azure Log              

                      RoleManager.WriteToLog("Critical",
string.Format("大厨已经在{0}把{1} 做好了。",DateTime.Now.ToString("HH点mm分ss秒"), msg.ContentAsString()));

                    // 记录删除刚才已经处理的那条消息

                      queue.DeleteMessage(msg);
}
}
}
}

这段程序中，值得注意的有三处：

1. 获取当前应该处理的数据：Message msg = queue.GetMessage();  既然是队列，就必须按照先进先出的顺序来操作数据。使用者也只能通过GetMessage方法取得队列中最靠前的那条数据，不能取到其他数据。就像是排队买火车票，售票员只能卖给排到队伍最靠前的那个人。
2. 删除消息：queue.DeleteMessage(msg);   这又像是排队买火车票，当排在最前面的那位仁兄买到票后，他应该马上从队伍中消失。
3. RoleManager.WriteToLog(string eventLogName,string message)方法。
   这就是上文提到的，非常简单好用的记录日志的方法。用过log4net的程序员一看就明白，这简直是一个“山寨版”的log4net。它借鉴了log4net记录日志的模式，又阉割了log4net的配置和自定义格式功能。
   Azure Log支持的EventLog类型共有Critical，Error，Warning,Information,Verbose这5种。如果你没用过log4net或不明白EventLog类型的意思，可以尝试这样理解：Azure Log把日志分为5类；分类记录日志更加便于查看。本例中使用的是"Critical”，也只是为了方便查看而已。

第七步：

F5运行程序。此时我们的Azure兰州拉面馆就正式在Development Fabric中开业了！

打开Development Fabric看看。

选择我们刚部署的服务中的Worker Role，点击右键，选择"Clear logs”清屏，再选择Logging Level- Critical 。这就是对日志进行分类查看，我们选择了查看Criticial类别是因为我们在记录点菜信息时使用了Critical 。

 

第八步：

测试一下吧 ：）

看，我们点菜，大厨依次做菜！

随便看一条数据吧，比如“(兰州版)扬州炒饭”这一项，我们在01点29分58秒的时候将它写入Queue。大厨发现Queue中有它后，在00点30分04秒中处理了它。

梳理一下流程：

点菜 - 把菜名写入Queue - 大厨每秒钟查看一次Queue，如果Queue中有需要做的菜，则按照先来后到的顺序做菜 -从记菜本中删除刚做好的菜 - 把做菜信息写入Azure Log中

 

到目前为止，我们掌握了：获取Queue Storage的引用、建立Queue、插入数据到Queue中(入队)、从Queue中取出数据(出队)、记录Azure系统日志、查看Azure系统日志。

 

                             ———患侏儒症的分割线———

【附件】：

传说中的万能StorageClient：StorageClient.rar

WPF应用程序Azure Log Viewer源代码：AzureLogViewer.zip

本文实验全部源代码：QueueStorage.rar