微软WP7本机数据库解决方案之Sqlite
请注意,尽管目前已有多个尝试实现了Windows Phone 7本地数据库支持,但最后,这些系统都需要运行于Windows Phone 7提供的独立存储基础之上。在本系列文章中,我将向你介绍上述成员之一-Sqlite Client for Windows Phone。这是一种新的,功能强大且易于使用的Windows Phone 7本机数据库解决方案,该系统公布于著名的开源网站CodePlex。篇幅所限,我仅介绍在Windows Phone 7系统中使用Sqlite Client for Windows Phone编程的部分技巧。
[备注]本系列文章中的案例程序调试环境包括:
1. Windows 7;
2. .NET 4.0;
3. Visual Studio 2010;
4. Windows Phone Developer Tools RTW;
5. Sqlite Client for Windows Phone (http://sqlitewindowsphone.codeplex.com/ );
6. (推荐) sqlite-manager (http://code.google.com/p/sqlite-manager/ );
7. (推荐) MVVM Light Toolkit (http://mvvmlight.codeplex.com/ ).
一、Sqlite Client for Windows Phone简介
大家都知道,SQLite是一个著名的开源的嵌入式的数据库系统,目前已经提供对于iOS和Android的良好支持。在此,应当让我们感谢Dan Ciprian Ardelean,是他带给我们WP7版本的SQLite-C#-SQLite!最近几个月,作者对早期的版本又进行了更新,得到一个功能更强大和更容易使用的解决方案,改名为Sqlite Client for Windows Phone,在知名的开源网站CodePlex上发布,网址是http://sqlitewindowsphone.codeplex.com/releases。
Sqlite Client for Windows Phone进行大范围的更新,如提供对于布尔类型、大型数据(Blobs)以及事务的全面支持,此外,下载包中还一并提供了一个全面的示例,供开发者学习之用。
接下来的操作就很简单了:重新构建源码工程,得到一个程序集Community.CsharpSqlite.WP.dll(Release版本大小是525 KB)。然后,在你的WP7 Silverlight 项目中添加对该程序集的引用。最后,你便可以使用Sqlite Client for Windows Phone提供的本地数据库支持功能了。
二、Sqlite Client for Windows Phone基础类库剖析
如果您以前有过任何基于SQL脚本的数据库编程经验,那么您可以轻松地使用Sqlite Client for Windows Phone功能。特别值得一提的是,此工程建基于以前的C#-SQLite项目之一,通过引入几个帮助器类(在文件SQLiteClient.cs),即SQLiteException、SQLiteConnection和SQLiteCommand,进一步简化了基本的数据库和表相关操作。
先别急,在正式使用Sqlite Client for Windows Phone之前,有必要再向您介绍另外一个非常有用的工具,名为sqlite-manager (http://code.google.com/p/sqlite-manager/)。这个工具是以FireFox插件的方式提供的。到现在您应该明白了,绝大多数与SQLite数据库相关的操作,例如创建SQLite数据库、表、视图、索引等等,都可以通过sqlite-manager轻松完成。
1.使用SQLite Manager简化数据库管理
如前所述,SQLite Manager是一个Firefox插件,使用Firefox的加载项管理器你可以很容易地获取和安装这个控件。
2.一个有用的工具类-DBHelper
如上所述,Sqlite Client for Windows Phone使用众所周知的SQL操作针对典型的数据库操作提供了一个高层次的封装。因此,在Silverlight for Windows Phone 7编程中为了处理SQLite数据库操作,我们可以直接使用在文件SQLiteClient.cs中定义的对象(在源库项目),即SQLiteException、SQLiteConnection和SQLiteCommand等。
虽然Sqlite Client for Windows Phone并没有提供与独立存储的直接互动,但显然增加对独立存储支持是必要的,这样可以改善系统的性能。因此,我们可以进一步封装前面提到的SQLiteClient对象。为此,Chris开发了一个非常好用的实用工具类,叫做DBHelper。为了应用于我们自己的示例,我对它做了轻微的修改。完整的源码如下。
列表1:更新版本的工具类DBHelper
using SQLiteClient;
using System.Linq;
using System.IO.IsolatedStorage;
using System.Collections.Generic;
using System.Collections.ObjectModel;
namespace WP7SQLiteClient.Helpers
{
public class DBHelper
{
private String _dbName;
private SQLiteConnection db = null;
public DBHelper(String assemblyName, String dbName)
{
IsolatedStorageFile store =IsolatedStorageFile.GetUserStoreForApplication();
if (!store.FileExists(dbName))
{
CopyFromContentToStorage(assemblyName, dbName);
}
_dbName = dbName;
}
~DBHelper()
{
Close();
}
private void Open()
{
{
db = new SQLiteConnection(_dbName);
db.Open();
}
}
private void Close()
{
if (db != null)
{
db.Dispose();
db = null;
}
}
//Insert operation
public int Insert(T obj, string statement) where T : new()
{
try
{
Open();
SQLiteCommand cmd = db.CreateCommand(statement);
int rec = cmd.ExecuteNonQuery(obj);
return rec;
}
catch (SQLiteException ex)
{
System.Diagnostics.Debug.WriteLine("Insert failed: " + ex.Message);
throw ex;
}
}
// Delete operation
public void Delete(string statement) where T : new()
{
try
{
SQLiteCommand cmd = db.CreateCommand(statement);
cmd.ExecuteNonQuery();
}
catch (SQLiteException ex)
{
System.Diagnostics.Debug.WriteLine("Deletion failed: " + ex.Message);
throw ex;
}
}
//Query operation
public List SelectList(String statement) where T : new()
{
Open();
SQLiteCommand cmd = db.CreateCommand(statement);
var lst = cmd.ExecuteQuery();
return lst.ToList();
}
public ObservableCollection SelectObservableCollection(String statement)
where T : new()
{
List lst = SelectList(statement);
ObservableCollection oc = new ObservableCollection();
foreach (T item in lst)
{
oc.Add(item);
}
return oc;
}
private void CopyFromContentToStorage(String assemblyName,String dbName)
{
IsolatedStorageFile store =
IsolatedStorageFile.GetUserStoreForApplication();
System.IO.Stream src =
Application.GetResourceStream(
new Uri("/" + assemblyName + ";component/" + dbName,
IsolatedStorageFileStream dest =
new IsolatedStorageFileStream(dbName,
System.IO.FileMode.OpenOrCreate,
System.IO.FileAccess.Write, store);
src.Position = 0;
CopyStream(src, dest);
dest.Flush();
dest.Close();
src.Close();
dest.Dispose();
}
private static void CopyStream(System.IO.Stream input,
IsolatedStorageFileStream output)
{
byte[] buffer = new byte[32768];
long TempPos = input.Position;
int readCount;
do
{
readCount = input.Read(buffer, 0, buffer.Length);
if (readCount > 0)
{
output.Write(buffer, 0, readCount);
}
} while (readCount > 0);
input.Position = TempPos;
}
}
}
顺便说一句,对于上面这个帮助类我也没有提供细致的优化编码。希望读者根据您的相关工作能够继续进行这项工作(例如提供更好的泛型化的CRUD支持)并分享给广大网友。简言之,我主要是增加了插入和删除方法。上面的代码中最引起您注意是地方一定是方法CopyFromContentToStorage,正是借助这个方法我们实现了上述目标-建立起SQLite数据库与独立存储的关系。