Enterprise Library深入解析与灵活应用(2): 通过SqlDependency实现Cache和Database的同步

对于一个真正的企业级的应用来说，Caching肯定是一个不得不考虑的因素，合理、有效地利用Caching对于增强应用的Performance（减少对基于Persistent storage的IO操作）、Scalability（将数据进行缓存，减轻了对Database等资源的压力）和Availability（将数据进行缓存，可以应对一定时间内的网络问题、Web Service不可访问问题、Database的崩溃问题等等）。Enterprise Library的Caching Application Block为我们提供了一个易用的、可扩展的实现Caching的框架。借助于Caching Application Block，Administrator和Developer很容易实现基于Caching的管理和编程。由于Caching的本质在于将相对稳定的数据常驻内存，以避免对Persistent storage的IO操作的IO操作，所以有两个棘手的问题：Load Balance问题；Persistent storage和内存中数据同步的问题。本篇文章提供了一个解决方案通过SqlDependency实现SQL Server中的数据和Cache同步的问题。

一、Cache Item的过期策略

在默认的情况下，通过CAB（以下对Caching Application Block的简称，注意不是Composite UI Application Block ）的CacheManager加入的cache item是永不过期的；但是CacheManager允许你在添加cache item的时候通过一个ICacheItemExpiration对象应用不同的过期策略。CAB定了一个以下一些class实现了ICacheItemExpiration，以提供不同的过期方式：

• AbsoluteTime：为cache item设置一个cache item的绝对过期时间。
• ExtendedFormatTime：通过一个表达式实现这样的过期策略：每分钟过期（*****：5个*分别代表minute、hour、date、month、year）；每个小时的第5分钟过期（5****）；每个月的2号零点零分过期（0 0 2 * *）。
• FileDependency：将cache item和一个file进行绑定，通过检测file的最后更新时间确定file自cache item被添加以来是否进行过更新。如果file已经更新则cache item过期。
• NeverExpired：永不过期。
• SlidingTime：一个滑动的时间，cache item的每次获取都将生命周期延长到设定的时间端，当cache item最后一次获取的时间算起，超出设定的时间，则cache item过期。

对于过期的cache item，会及时地被清理。所以要实现我们开篇提出的要求：实现Sql Server中的数据和Cache中的数据实现同步，我们可以通过创建基于Sql Server数据变化的cache item的过期策略。换句话说，和FileDependency，当Persistent storage（Database）的数据变化本检测到之后，对于得cache自动过期。但是，对于文件的修改和删除，我们和容易通过文件的最后更新日期或者是否存在来确定。对于Database中Table数据的变化的探测就不是那么简单了。不过SQL Server提供了一个SqlDependency的组建帮助我们很容易地实现了这样的功能。

二、创建基于SqlDependency的ICacheItemExpiration

SqlDependency是建立在SQL Server 2005的Service Broker之上。SqlDependency向SQL Server订阅一个Query Notification。当SQL Server检测到基于该Query的数据发生变化，向SqlDependency发送一个Notification，并触发SqlDependency的Changed事件，我们就可以通过改事件判断对应的cache item是否应该过期。

我们现在就来创建这样的一个ICacheItemExpiration。我们先看看ICacheItemExpiration的的定义：

public interface ICacheItemExpiration
{
    // Methods
    bool HasExpired();
    void Initialize(CacheItem owningCacheItem);
    void Notify();
}

而判断过期的依据就是根据HasExpired方法，我们自定义的CacheItemExpiration就是实现了该方法，根据SqlDependency判断cache item是否过期。下面是SqlDependencyExpiration的定义（注：SqlDependencyExpiration的实现通过Enterprise Library DAAB实现DA操作）：

namespace Artech.SqlDependencyCaching
{
    public class SqlDependencyExpiration : ICacheItemExpiration
    {
        private static readonly CommandType DefaultComamndType = CommandType.StoredProcedure;

        public event EventHandler Expired;

        public bool HasChanged
        { get; set; }

        public string ConnectionName
        { get; set; }

        public SqlDependencyExpiration(string commandText, IDictionary<string, object> parameters) :
            this(commandText, DefaultComamndType, string.Empty, parameters)
        { }

        public SqlDependencyExpiration(string commandText, string connectionStringName, IDictionary<string, object> parameters) :
            this(commandText, DefaultComamndType, connectionStringName, parameters)
        { }

        public SqlDependencyExpiration(string commandText, CommandType commandType, IDictionary<string, object> parameters) :
            this(commandText, commandType, string.Empty, parameters)
        { }

        public SqlDependencyExpiration(string commandText, CommandType commandType, string connectionStringName, IDictionary<string, object> parameters)
        {
            if (string.IsNullOrEmpty(connectionStringName))
            {
                this.ConnectionName = DatabaseSettings.GetDatabaseSettings(ConfigurationSourceFactory.Create()).DefaultDatabase;
            }
            else
            {
                this.ConnectionName = connectionStringName;
            }

            SqlDependency.Start(ConfigurationManager.ConnectionStrings[this.ConnectionName].ConnectionString);
            using (SqlConnection sqlConnection = DatabaseFactory.CreateDatabase(this.ConnectionName).CreateConnection() as SqlConnection)
            {
                SqlCommand command = new SqlCommand(commandText, sqlConnection);
                command.CommandType = commandType;
                if (parameters != null)
                {
                    this.AddParameters(command, parameters);
                }
             SqlDependency dependency = new SqlDependency(command);
                dependency.OnChange += delegate
                {
                    this.HasChanged = true;
                    if (this.Expired != null)
                    {
                        this.Expired(this, new EventArgs());
                    }
                };
                if (sqlConnection.State != ConnectionState.Open)
                {
                    sqlConnection.Open();
                }
                command.ExecuteNonQuery();
            }
        }

        private void AddParameters(SqlCommand command, IDictionary<string, object> parameters)
        {
            command.Parameters.Clear();
            foreach (var parameter in parameters)
            {
                string parameterName = parameter.Key;
                if (!parameter.Key.StartsWith("@"))
                {
                    parameterName = "@" + parameterName;
                }

                command.Parameters.Add(new SqlParameter(parameterName, parameter.Value));
            }
        }

        #region ICacheItemExpiration Members

        public bool HasExpired()
        {
            bool indicator = this.HasChanged;
            this.HasChanged = false;
            return indicator;
        }

        public void Initialize(CacheItem owningCacheItem)
        {         }

        public void Notify()
        {         }

        #endregion
    }
}

我们来简单分析一下实现过程，先看看Property定义：

private static readonly CommandType DefaultComamndType = CommandType.StoredProcedure;

public event EventHandler Expired;

public bool HasChanged
{ get; set; }

public string ConnectionName
{ get; set; }

通过DefaultComamndType 定义了默认的CommandType，在这了我默认使用Stored Procedure；Expired event将在cache item过期时触发；HasChanged代表Database的数据是否被更新，将作为cache过期的依据；ConnectionName代表的是Connection string的名称。

为了使用上的方便，我定义了4个重载的构造函数，最后的实现定义在public SqlDependencyExpiration(string commandText, CommandType commandType, string connectionStringName, IDictionary<string, object> parameters)。parameters代表commandText的参数列表，key为参数名称，value为参数的值。首先获得真正的connection string name（如果参数connectionStringName为空，就使用DAAB默认的connection string）

if (string.IsNullOrEmpty(connectionStringName))
{
     this.ConnectionName = DatabaseSettings.GetDatabaseSettings(ConfigurationSourceFactory.Create()).DefaultDatabase;
}
else
{
     this.ConnectionName = connectionStringName;
}

然后通过调用SqlDependency.Start（）方法，并传入connection string作为参数。该方法将创建一个Listener用于监听connection string代表的database instance发送过来的query notifucation。

SqlDependency.Start(ConfigurationManager.ConnectionStrings[this.ConnectionName].ConnectionString);

然后创建SqlConnection，并根据CommandText和CommandType参数创建SqlCommand对象，并将参数加入到command的参数列表中。最后将这个SqlCommand对象作为参数创建SqlDependency 对象，并注册该对象的OnChange 事件（对HasChanged 赋值；并触发Expired事件）。这样当我们执行该Cmmand之后，当基于commandtext的select sql语句获取的数据在database中发生变化（添加、更新和删除），SqlDependency 的OnChange 将会触发

SqlDependency dependency = new SqlDependency(command);
dependency.OnChange += delegate
{
      this.HasChanged = true;
       if (this.Expired != null)
       {
              this.Expired(this, new EventArgs());

       }

};

这样在HasExpired方法中，就可以根据HasChanged 属性判断cache item是否应该过期了。

public bool HasExpired()
{
     bool indicator = this.HasChanged;
     this.HasChanged = false;
     return indicator;
}

 三、如何应用SqlDependencyExpiration

我们现在创建一个简单的Windows Application来模拟使用我们创建的SqlDependencyExpiration。我们模拟一个简单的场景：假设我们有一个功能需要向系统所有的user发送通知，而且不同的user，通知是不一样的，由于通知的更新的频率不是很高，我们需要讲某个User的通知进行缓存。

这是我们的表结构：Messages

我们通过下面的SP来获取基于某个User 的Message：

ALTER PROCEDURE [dbo].[Message_Select_By_User]
(@UserID    VarChar(50))
AS
BEGIN
    Select ID, UserID, [Message] From dbo.Messages Where UserID = @UserID
END

注：如何写成Select * From dbo.Messages Where UserID = @UserID, SqlDependency 将不能正常运行；同时Table的schema（dbo）也是必须的。

我们设计如下的界面来模拟：通过Add按钮，可以为选择的User创建新的Message，而下面的List将显示基于某个User（Foo）的Message List。该列表的获取方式基于Lazy Loading的方式，如果在Cache中，则直接从Cache中获取，否则从Db中获取，并将获取的数据加入cache。

我们先定义了3个常量，分别表示：缓存message针对的User，获取Message list的stored procedure名称和Cache item的key。

private const string UserName = "Foo";
private const string MessageCachingProcedure = "Message_Select_By_User";
private const string CacheKey = "__MessageOfFoo";

我们通过一个Property来创建或获取我们的上面定义的SqlDependencyExpiration 对象

private SqlDependencyExpiration CacheItemExpiration
{
    get
    {
        IDictionary<string, object> parameters = new Dictionary<string, object>();
        parameters.Add("UserID", UserName);
        SqlDependencyExpiration expiration= new SqlDependencyExpiration(MessageCachingProcedure, parameters);
        expiration.Expired += delegate
        {
            MessageBox.Show("Cache has expired!");
        };

        return expiration;
    }
}

通过GetMessageByUser从数据库中获取基于某个User的Message List（使用了DAAB）：

private List<string> GetMessageByUser(string userName)
{
    List<string> messageList = new List<string>();
    Database db = DatabaseFactory.CreateDatabase();
    DbCommand command = db.GetStoredProcCommand(MessageCachingProcedure);
    db.AddInParameter(command, "UserID", DbType.String, userName);
    IDataReader reader = db.ExecuteReader(command);
    while (reader.Read())
    {
        messageList.Add(reader.GetString(2));
    }

    return messageList;
}

通过GetMessages获取User（Foo）的Message List：首先通过CacheManager检测message list是否存在于Cache，如何不存在，调用上面的GetMessageByUser方法从database中获取Foo的message list。并将其加入Cache中，需要注意的是这里使用到了我们的SqlDependencyExpiration 对象。

private List<string> GetMessages()
{
    ICacheManager manager = CacheFactory.GetCacheManager();
    if (manager.GetData(CacheKey) == null)
    {
        manager.Add(CacheKey, GetMessageByUser(UserName), CacheItemPriority.Normal, null, this.CacheItemExpiration);
    }

    return manager.GetData(CacheKey) as List<string>;
}

由于在我们的例子中需要对DB进行数据操作，来检测数据的变换是否应用Cache的过期，我们需要想数据库中添加Message。我们通过下面的方式现在message的添加。

private void CreateMessageEntry(string userName, string message)
{
    Database db = DatabaseFactory.CreateDatabase();
    string insertSql = "INSERT INTO [dbo].[Messages]([UserID],[Message])VALUES(@userID, @message)";
    DbCommand command = db.GetSqlStringCommand(insertSql);
    db.AddInParameter(command, "userID", DbType.String, userName);
    db.AddInParameter(command, "message", DbType.String, message);
    db.ExecuteNonQuery(command);
}

我们的Add按钮的实现如下：基于我们选择的Username和输入的message的内容向DB中添加Message，然后调用GetMessages()方法获取基于用户Foo的Message列表。之所以要在两者之间将线程休眠1s，是为了上SqlDependency有足够的时间结果从Database传过来的Query Notification，并触发OnChanged事件并执行相应的Event Handler，这样调用GetMessages时检测Cache才能检测到cache item已经过期了。

private void buttonAdd_Click(object sender, EventArgs e)
{
    this.CreateMessageEntry(this.comboBoxUserName.SelectedValue.ToString(), this.textBoxMessage.Text.Trim());
    Thread.Sleep(1000);
    this.listBoxMessage.DataSource = this.GetMessages();
}

由于我们缓存了用户Foo的Message list，所以当我们为Foo创建Message的时候，下面的ListBox的列表能够及时更新，这表明我们的cache item已经过期了。而我们为其他的用户（Bar，Baz）创建Message的时候，cache item将不会过期，这一点我们可以通过弹出的MessageBox探测掉（expiration.Expired += delegate           MessageBox.Show("Cache has expired!");}; ），只有前者才会弹出下面的MessageBox：

注：由于SqlDependency建立在Service Broker之上的，所以我们必须将service Broker开关打开（默认使关闭的）。否则我们将出现下面的错误：

打开service Broker可以通过如下的T-SQL：

ALTER DATABASE MyDb SET ENABLE_BROKER ;

Source Code:http://files.cnblogs.com/artech/Artech.SqlDependencyCaching.zip