Xamarin.Android之SQLite.NET ORM

浏览数：21 / 时间：2015年06月11日

一、前言

通过《Xamarin.Android之SQLiteOpenHelper》和《Xamarin.Android之ContentProvider》的学习，我们已经掌握了如何使用特定于该平台的数据库操作。但是这样却和Xamarin所宣称的跨平台相违背了，因为这样我们就需要针对不同的平台编写不同的代码，而本章将使用Github上的开源项目SQLite.NET去解决这个问题，从而可以实现跨平台，减少代码的重复。

关于该开源项目请点我

二、准备工作

因为这个库很大，而我们只需要其中的一个.cs文件就可以了，所以笔者这里已经封装好了一个库，里面不仅包含了这个库，还包含了可以跨平台的网络连接。

点我下载

因为该库还使用了一个json库，所以读者也一并要下载并引用

点我下载

然后新建一个Android Application项目（.net 4.0）并且SDK版本设置为14（Android 4.0），下面我们就可以开始正式学习了。

三、正文

1.引用命名空间

打开MainActivity类并在顶部加上如下引用

1 using NSCPAndroid.SQLite;

2.创建一个映射类

有过一定开发经验的人一定会很熟悉ORM，笔者平时用的最多的就是EF、Castle Active Record。当然还有很多其他更优秀的框架。不熟悉的人也没有关系，下面我们只是新建一个类，而这个类的结构完全是对应到数据库中的表的。比如笔者在这里创建一个名为Stock的表：

1 [Table("Stock")]
2 public class StockTable
3 {
4      [PrimaryKey, AutoIncrement, Column("_id")]
5      public int Id { get; set; }
6 
7      [MaxLength(8)]
8      public string Symbol { get; set; }
9 }

其中我们可以看到Table这个注解属性，含义就是这个类对应到数据库中的表名。读者不要误认为是依照类名，下面就是两个字段其中关键的就是主键，因为SQLite规定主键必须由自身维护，所以这里我们使用了PrimaryKey注解属性表示该属性为主键，AutoIncrement表示该主键为自增，最后就是Column表示该字段对应到该表的字段名（名字必须为_id），下面一个就是我们自己的字段了，笔者使用了MaxLength表示该字段最大可以保存八个字符。

关于更多的注解属性可以看下面的介绍。

[PrimaryKey]：表示该表的主键，只能用于Int类型的属性。

[AutoIncrement]：用于需要自增的属性，每插入一条新数据该字段都会自增，只能用于Int类型。

[Column(name)]：用来表示指定属性对应到表中字段的名称，如果不加该属性则表中的字段名与属性名相同。

[Table(name)]：用来表示指定类对应到数据库中的表名称，如果不加该属性则数据库中的表名称与该类名称相同。

[MaxLength(value)]：用来限制字段能够保存的最长字符长度。

[Ignore]：表示忽略该属性，从而不会在表中生成对应的字段。

[Unique]：表示该属性的值必须在表中唯一。

3.创建数据库连接

我们需要指定数据库所保存的路径，同时还要打开该数据库。如果不存在该数据库，则会自动创建该文件。下面的代码我们将获取数据库的路径并打开该数据库：

1 string dbPath = Path.Combine(System.Environment.
2 GetFolderPath(System.Environment.SpecialFolder.Personal),"ormdemo.db3");
3 var db = new SQLiteConnection(dbPath);

这里要注意我们用的是SQLiteConnection打开该数据库的，而不是SqlConnection。成功打开该数据库之后剩下的工作我们只需要利用db就可以轻松完成了，到现在为止我们仅仅创建了一个空的数据库，里面还不存在任何表。

4.创建表

第2步我们已经创建好了一个表的结构，下面我们将在数据库中创建对应的表，我们只需要通过下面的代码就可以轻松的创建一个表了：

1 db.CreateTable<StockTable>();

或者下面这个方式也一样可以：

1 db.CreateTable(typeof(StockTable));

创建完之后表还是空的，所以接下来我们需要插入几条数据，这样才能介绍其他的操作。

注：实际运用中一定会有人想找如何判断该表是否已经创建的方法，其实没有必须要找，即使重复的执行该操作，也不会影响什么，表一旦创建之后在执行就不会重新创建了。

5.插入数据

这里我们直接通过创建StockTable的实例来插入到数据库中，比如下面的代码我们将会插入一条数据：

1 var newStock = new StockTable();
2 newStock.Symbol = "First";
3 db.Insert(newStock);

是不是十分简单，仅仅只需要调用Insert即可,该方法还会返回插入数据的主键。但是这只是插入一条数据，如果我们需要插入多条数据呢？当然不可能用foreach，已经提供了另一个方法InsertAll，比如下面的示例将会同时插入多条数据：

 1 List<StockTable> stocks = new List<StockTable>
 2 {
 3     new StockTable{
 4             Symbol = "First"
 5     },
 6     new StockTable{
 7             Symbol = "Second"
 8     }
 9 };
10 db.InsertAll(stocks);

如果读者需要验证下是不是插入了，我们可以获取该表有多少数据即可，比如下面的代码：

1 int count = db.Table<StockTable>().Count();

这时表里已经有数据了，下面我们就需要进行查询。

6.查询数据

首先介绍最简单的查询方式，就是依靠id来直接获取。当然我们不需要拼接任何SQL，只需要通过下面这段代码就可以获取id为1的数据了：

1 var item = db.Get<StockTable>(1);

但是大多数情况下我们都需要通过条件语句进行查询，那样我们就需要使用SQL语句了，比如下面的查询语句，我们将查询Symbol开头为“F”的数据：

1 var items = db.Query<StockTable>(" select * from Stock where Symbol like ? ", "F%");

相信那些对技术比较追求的人一定知道Linq，它让我们摆脱的拼接SQL语句的尴尬，使得查询变的简单有趣（复杂的查询还是需要采用SQL，甚至是存储过程等），当然在这里我们依然可以使用这一特性，下面我们将上面的代码改写成Linq：

1 var items = (from item in db.Table<StockTable>()
2                 where item.Symbol.StartsWith("F")
3                 select item).GetEnumerator();

笔者为了能够更快的查看结果，所以使用了GetEnumerator，实际使用中不一定需要。如果读者喜欢最原始的查询可以用ExecuteScalar方法。

注：linq的查询是属于延迟查询的，意味着在查询的那一刻并没有把结果查询出来，而是等待你使用它的时候才查询。

7.更新和删除数据

首先我们先将更新数据，因为它的操作跟插入数据是一样的存在Update和UpdateAll，只是数据的主键需要有数据，否则无法定位是更新哪个数据，下面我们将演示如何利用Update更新数据：

1 var result = (from item in db.Table<StockTable>()
2                   where item.Symbol.StartsWith("F")
3                   select item).First();
4 result.Symbol = "Third";
5 db.Update(result);
6 
7 result = db.Get<StockTable>(result.Id);

既然是更新当然需要先获取一条数据然后更新，最后还要从数据库中拿出来，确定是否已经更新成功。下面我们继续删除操作：

1 var result = (from item in db.Table<StockTable>()
2           where item.Symbol.StartsWith("T")
3           select item).First();
4 
5 db.Delete<StockTable>(result.Id);