Xamarin.Android之SQLite.NET ORM

一、前言

通过《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,笔者平时用的最多的就是EFCastle 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的查询是属于延迟查询的,意味着在查询的那一刻并没有把结果查询出来,而是等待你使用它的时候才查询。

 

推荐:

1.Jesse Liu的随笔《快乐的lambda表达式》,个人感觉很有意思,也很有用。

2.关于Linq如何实现动态查询的文章点我,动态查询可以认为是用字符串拼接Linq的部分语句,这样做的目的是为了解决某些特殊场合下的使用。

关于查询数据到此结束了,下面我们将学习剩下的两个操作分别是更新和删除。

 

7.更新和删除数据

首先我们先将更新数据,因为它的操作跟插入数据是一样的存在UpdateUpdateAll,只是数据的主键需要有数据,否则无法定位是更新哪个数据,下面我们将演示如何利用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);

如果你需要删除整个表的数据只需要使用DeleteAll即可,当然这些操作都是有限的,所以我们还需要支持SQL的方法,那么我们可以使用Execute即可。

 

最后结果给大家一个本人比较喜欢ORM,用在网站开发上的

 

Xamarin.Android之SQLite.NET ORM

上一篇:Android Studio 100 tips and tricks


下一篇:Android 二维码 生成和识别(附Demo源码)