Android数据库高手秘籍(五)——LitePal的存储操作

使用LitePal存储数据

LitePal中与存储相关的API其实并不多,但用法还是颇为丰富的,而且比起传统的insert()方法,使用LitePal来存储数据可以简单到让你惊叹的地步,那么今天我们就来完整地学习一下LitePal存储数据的所有用法。

在前面几篇文章当中,我们在项目里已经建好了News、Comment、Introduction、Category这几个实体类,通过这些实体类,LitePal就可以把相应的表自动创建出来。现在来观察这几个实体类,我们发现这几个类都是没有继承结构的。没错,因为LitePal进行表管理操作时不需要这些实体类有任何的继承结构,当时为了简单起见就没有写。但是进行CRUD操作时就不行了,LitePal要求所有的实体类都要继承自DataSupport这个类,因此这里我们就要把继承结构给加上才行。修改News类的代码,如下所示:

[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. public class News extends DataSupport{  
  2.       
  3.     ......  
  4.       
  5.     // 自动生成get、set方法  
  6. }  
可以看到,这里只是让News类继承自了DataSupport,其它什么都没有改变。另外几个Comment、Introduction、Category类也使用同样的改法,这里就不一一演示了。

继承了DataSupport类之后,这些实体类就拥有了进行CRUD操作的能力,那么比如想要存储一条数据到news表当中,就可以这样写:

[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. News news = new News();  
  2. news.setTitle("这是一条新闻标题");  
  3. news.setContent("这是一条新闻内容");  
  4. news.setPublishDate(new Date());  
  5. news.save();  
怎么样?是不是非常简单,不需要SQLiteDatabase,不需要ContentValues,不需要通过列名组装数据,甚至不需要指定表名,只需要new出一个News对象,然后把要存储的数据通过setter方法传入,最后调用一下save()方法就好了,而这个save()方法自然就是从DataSupport类中继承而来的了。

除此之外,save()方法还是有返回值的,我们可以根据返回值来判断存储是否成功,比如说这样写:

[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. if (news.save()) {  
  2.     Toast.makeText(context, "存储成功", Toast.LENGTH_SHORT).show();  
  3. else {  
  4.     Toast.makeText(context, "存储失败", Toast.LENGTH_SHORT).show();  
  5. }  
可以看出,save()方法返回的是一个布尔值,用于表示存储成功还是失败,但同时也说明这个方法是不会抛出异常的。有些朋友希望如果存储失败的话就抛出异常,而不是返回一个false,那就可以使用saveThrows()方法来代替,如下所示:
[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. News news = new News();  
  2. news.setTitle("这是一条新闻标题");  
  3. news.setContent("这是一条新闻内容");  
  4. news.setPublishDate(new Date());  
  5. news.saveThrows();  
使用saveThrows()方法来存储数据,一旦存储失败就会抛出一个DataSupportException异常,我们可以通过对这个异常进行捕获来处理存储失败的情况。

那有些细心的朋友可能已经注意到,使用的insert()方法来存储数据时是有返回值的,返回的是插入行对应的id。但LitePal中的save()方法返回的是布尔值,那么我们怎样才能拿到存储成功之后这条数据对应的id呢?对此,LitePal使用了一种非常巧妙的做法,还记得我们在每个实体类中都定义了一个id字段吗?当调用save()方法或saveThrows()方法存储成功之后,LitePal会自动将该条数据对应的id赋值到实体类的id字段上。让我们来做个试验吧,代码如下所示:

[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. News news = new News();  
  2. news.setTitle("这是一条新闻标题");  
  3. news.setContent("这是一条新闻内容");  
  4. news.setPublishDate(new Date());  
  5. Log.d("TAG""news id is " + news.getId());  
  6. news.save();  
  7. Log.d("TAG""news id is " + news.getId());  
在save之前打印一下news的id,在save之后再打印一次,现在运行一下,打印结果如下所示:


OK,在save之前打印的id是0,说明此时id这个字段还没有被赋值,在save之后打印的id是1,说明此时id已经被赋值了。那么我们再到数据库表中再查看一下这条记录到底有没有存储成功吧,如下图所示:


可以看到,这条新闻确实已经存储成功了,并且对应的id正是1,和我们前面打印的结果是一致的。

不过LitePal的存储功能显示不仅仅只有这些用法,事实上,LitePal在存储数据的时候默默帮我们做了很多的事情,比如多个实体类之间有关联关系的话,我们不需要考虑在存储数据的时候怎么去建立数据与数据之间的关联,因为LitePal一切都帮我们做好了。

还是通过一个例子来看一下吧,Comment和News之间是多对一的关系,一条News中是可以包含多条评论的,因此我们就可以这样写:

[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. Comment comment1 = new Comment();  
  2. comment1.setContent("好评!");  
  3. comment1.setPublishDate(new Date());  
  4. comment1.save();  
  5. Comment comment2 = new Comment();  
  6. comment2.setContent("赞一个");  
  7. comment2.setPublishDate(new Date());  
  8. comment2.save();  
  9. News news = new News();  
  10. news.getCommentList().add(comment1);  
  11. news.getCommentList().add(comment2);  
  12. news.setTitle("第二条新闻标题");  
  13. news.setContent("第二条新闻内容");  
  14. news.setPublishDate(new Date());  
  15. news.setCommentCount(news.getCommentList().size());  
  16. news.save();  
可以看到,这里先是存储了一条comment1数据,然后存储一条comment2数据,接着在存储News之前先把刚才的两个Comment对象添加到了News的commentList列表当中,这样就表示这两条Comment是属于这个News对象的,最后再把News存储到数据库中,这样它们之间的关联关系就会自动建立了。让我们查看数据库表检查一下吧,首先看一下news表,如下所示:


OK,第二条新闻已经成功存储到news表中了,这条新闻的id是2。那么从哪里可以看出来关联关系呢?我们在上一篇文章中学过,多对一关联的时候,外键是存放在多方的,因此关联关系我们要到comment表中去查看,如下所示:


可以看到,两条评论都已经成功存储到comment表中了,并且这两条评论的news_id都是2,说明它们是属于第二条新闻的。怎么样,仅仅是在存储数据之前建立好实体类之间的关系,再调用一下save()方法,那么数据之间的关联关系就会自动建立了,是不是非常简单?上面的代码只是多对一情况的一种用法,还有一对一和多对多的情况,其实用法都是差不多的,相信你已经能举一反三了。

另外,LitePal对集合数据的存储还专门提供了一个方法,比如说我们有一个News集合,那么应该怎样去存储这个集合中的每条News呢?传统情况下可以这样写:

[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. List<News> newsList;  
  2. ...  
  3. for (News news : newsList) {  
  4.     news.save();  
  5. }  
通过一个循环来遍历出这个集合中的每一个News对象,然后逐个调用save()方法。这样的写法当然是可以的,但是效率会比较低,因为调用save()方法的时候除了会执行存储操作之外,还会去分析News类的关联关系,那么每次循环都去重新分析一遍关联关系显然是比较耗时的。因此,LitePal提供了一个saveAll()方法,专门用于存储集合数据的,用法如下所示:
[java]  view plain  copy
  在CODE上查看代码片 派生到我的代码片
  1. List<News> newsList;  
  2. ...  
  3. DataSupport.saveAll(newsList);  
saveAll()方法接收一个Collection集合参数,只要把待存储的集合数据传入即可。这个方法可以完成和上面一段代码完全一样的功能,但效率却会高得多,而且写法也更加简单。

好了,这样我们就把LitePal中提供的存储操作的用法全部都学完了,那么今天的文章就到这里,下一篇文章当中会开始讲解更新和删除操作的用法。感兴趣的朋友请继续阅读 Android数据库高手秘籍(六)——LitePal的修改和删除操作 。

LitePal开源项目地址:https://github.com/LitePalFramework/LitePal

第一时间获得博客更新提醒,以及更多技术信息分享,欢迎关注我的微信公众号,扫一扫下方二维码或搜索微信号guolin_blog,即可关注。

猜你喜欢

转载自blog.csdn.net/u013360656/article/details/52810336
今日推荐