Android数据库高手秘籍(三)——使用LitePal升级表

在上一篇文章中，我们学习了LitePal的基本用法，体验了使用框架来进行创建表操作的便利。然而大家都知道，创建表只是数据库操作中最基本的一 步而已，我们在一开始创建的表结构，随着需求的变更，到了后期是极有可能需要修改的。因此，升级表的操作对于任何一个项目也是至关重要的，那么今天我们就 一起来学习一下，在Android传统开发当中升级表的方式，以及使用LitePal来进行升级表操作的用法。如果你还没有看过前一篇文章，建议先去参考 一下 Android数据库高手秘籍(二)——创建表和LitePal的基本用法 。

LitePal的项目地址是：https://github.com/LitePalFramework/LitePal

传统的升级表方式

上一篇文章中我们借助MySQLiteHelper已经创建好了news这张表，这也是demo.db这个数据库的第一个版本。然而，现在需求发生了变更，我们的软件除了能看新闻之外，还应该允许用户评论，所以这时就需要对数据库进行升级，添加一个comment表。

该怎么做呢？添加一个comment表的建表语句，然后在onCreate()方法中去执行它？没错，这样的话，两张表就会同时创建了，代码如下所示：

[java] view plaincopy

  1. public class MySQLiteHelper extends SQLiteOpenHelper {
  2. public static final String CREATE_NEWS = "create table news ("
  3. + "id integer primary key autoincrement, "
  4. + "title text, "
  5. + "content text, "
  6. + "publishdate integer,"
  7. + "commentcount integer)";
  8. public static final String CREATE_COMMENT = "create table comment ("
  9. + "id integer primary key autoincrement, "
  10. + "content text)";
  11. public MySQLiteHelper(Context context, String name, CursorFactory factory,
  12. int version) {
  13. super(context, name, factory, version);
  14. }
  15. @Override
  16. public void onCreate(SQLiteDatabase db) {
  17. db.execSQL(CREATE_NEWS);
  18. db.execSQL(CREATE_COMMENT);
  19. }
  20. @Override
  21. public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
  22. }
  23. }

这对于第一次安装我们软件的用户来说是完全可以正常工作的，但是如果有的用户已经安装过上一版的软件，那么很遗憾，comment表是创建不出来的，因为之前数据库就已经创建过了，onCreate()方法是不会重新执行的。

对 于这种情况我们就要用升级的方式来解决了，看到MySQLiteHelper构造方法中的第四个参数了吗，这个就是数据库版本号的标识，每当版本号增加的 时候就会调用onUpgrade()方法，我们只需要在这里处理升级表的操作就行了。比较简单粗暴的方式是将数据库中现有的所有表都删除掉，然后重新创 建，代码如下所示：

[java] view plaincopy

  1. public class MySQLiteHelper extends SQLiteOpenHelper {
  2. ......
  3. @Override
  4. public void onCreate(SQLiteDatabase db) {
  5. db.execSQL(CREATE_NEWS);
  6. db.execSQL(CREATE_COMMENT);
  7. }
  8. @Override
  9. public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
  10. db.execSQL("drop table if exists news");
  11. onCreate(db);
  12. }
  13. }

可以看到，当数据库升级的时候，我们先把news表删除掉，然后重新执行了一次onCreate()方法，这样就保证数据库中的表都是最新的了。

但 是，如果news表中本来已经有数据了，使用这种方式升级的话，就会导致表中的数据全部丢失，所以这并不是一种值得推荐的升级方法。那么更好的升级方法是 什么样的呢？这就稍微有些复杂了，需要在onUpgrade()方法中根据版本号加入具体的升级逻辑，我们来试试来吧。比如之前的数据库版本号是1，那么 在onUpgrade()方法中就可以这样写：

[java] view plaincopy

  1. public class MySQLiteHelper extends SQLiteOpenHelper {
  2. ......
  3. @Override
  4. public void onCreate(SQLiteDatabase db) {
  5. db.execSQL(CREATE_NEWS);
  6. db.execSQL(CREATE_COMMENT);
  7. }
  8. @Override
  9. public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
  10. switch (oldVersion) {
  11. case 1:
  12. db.execSQL(CREATE_COMMENT);
  13. default:
  14. }
  15. }
  16. }

可以看到，这里在onUpgrade()方法中加入了一个switch判断，如果oldVersion等于1，就再创建一个comment表。现在只需要调用如下代码，表就可以得到创建或升级了：

[java] view plaincopy

  1. SQLiteOpenHelper dbHelper = new MySQLiteHelper(this, "demo.db", null, 2);
  2. SQLiteDatabase db = dbHelper.getWritableDatabase();

这里我们将版本号加1，如果用户是从旧版本升级过来的，就会新增一个comment表，而如果用户是直接安装的新版本，就会在onCreate()方法中把两个表一起创建了。

OK， 现在软件的第二版本也发布出去了，可是就在发布不久之后，突然发现comment表中少了一个字段，我们并没有记录评论发布的时间。没办法，只好在第三版 中修复这个问题了，那我们该怎么样去添加这个字段呢？主要需要修改comment表的建表语句，以及onUpgrade()方法中的逻辑，代码如下所示：

[java] view plaincopy

  1. public class MySQLiteHelper extends SQLiteOpenHelper {
  2. ......
  3. public static final String CREATE_COMMENT = "create table comment ("
  4. + "id integer primary key autoincrement, "
  5. + "content text, "
  6. + "publishdate integer)";
  7. ......
  8. @Override
  9. public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
  10. switch (oldVersion) {
  11. case 1:
  12. db.execSQL(CREATE_COMMENT);
  13. break;
  14. case 2:
  15. db.execSQL("alter table comment add column publishdate integer");
  16. break;
  17. default:
  18. }
  19. }
  20. }

可 以看到，在建表语句当中我们新增了publishdate这一列，这样当执行onCreate()方法去创建表的时候，comment表中就会有这一列 了。那么如果是从旧版本升级过来的呢？也没有问题，我们在onUpgrade()方法中已经把升级逻辑都处理好了，当oldVersion等于2的时候， 会执行alter语句来添加publishdate这一列。现在调用以下代码来创建或升级数据库：

[java] view plaincopy

  1. SQLiteOpenHelper dbHelper = new MySQLiteHelper(this, "demo.db", null, 3);
  2. SQLiteDatabase db = dbHelper.getWritableDatabase();

将数据库版本号设置成3，这样就可以保证数据库中的表又是最新的了。

现 在我们已经学习了新增表和新增列这两种升级方式，那么如果是某张表中的某一列已经没有用了，我想把这一列删除掉该怎么写呢？很遗憾，SQLite并不支持 删除列的功能，对于这情况，多数软件采取的作法是无视它，反正以后也用不到它了，留着也占不了什么空间，所以针对于这种需求，确实没什么简单的解决办法。

这 大概就是传统开发当中升级数据库表的方式了，虽说能写出这样的代码表示你已经对数据库的升级操作理解的比较清楚了，但随着版本越来越 多，onUpgrade()方法中的逻辑也会变得愈发复杂，稍微一不留神，也许就会产生错误。因此，如果能让代码自动控制升级逻辑，而不是由人工来管理， 那就是再好不过了，那么下面我们就来学习一下怎样使用LitePal来进行升级表的操作。

使用LitePal升级表

通 过上一篇文章的学习，我们已经知道LitePal是一款ORM模式的框架了，已经熟悉创建表流程的你，相信对于升级表也一定会轻车熟路的。那么为了模仿传 统升级表方式中的需求，现在我们也需要创建一张comment表。第一步该怎么办呢？相信你也许早就已经猜到了，那当然是先创建一个Comment类了， 如下所示：

[java] view plaincopy

  1. package com.example.databasetest.model;
  2. public class Comment {
  3. private int id;
  4. private String content;
  5. // 自动生成get、set方法
  6. ...
  7. }

OK，Comment类中有id和content这两个字段，也就意味着comment表中会有id和content这两列。

接着修改litepal.xml中的配置，在映射列表中新增Cooment类，并将版本号加1，如下所示：

[html] view plaincopy

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <litepal>
  3. <dbname value="demo" ></dbname>
  4. <version value="2" ></version>
  5. <list>
  6. <mapping class="com.example.databasetest.model.News"></mapping>
  7. <mapping class="com.example.databasetest.model.Comment"></mapping>
  8. </list>
  9. </litepal>

没错，就是这么简单，仅仅两步，升级的操作就已经完成了，现在我们只需要操作一下数据库，comment表就会自动生成了，如下所示：

[java] view plaincopy

  1. SQLiteDatabase db = Connector.getDatabase();

那么我们还是通过.table命令来查看一下结果，如下图所示：

OK，comment表已经出来了，那么再通过pragma命令来查看一下它的表结构吧：

没有问题，comment表中目前有id和content这两列，和Comment模型类中的字段是保持一致的。

那么现在又来了新的需求，需要在comment表中添加一个publishdate列，该怎么办呢？不用怀疑，跟着你的直觉走，相信你已经猜到应该在Comment类中添加这样一个字段了吧，如下所示：

[java] view plaincopy

  1. public class Comment {
  2. private int id;
  3. private String content;
  4. private Date publishDate;
  5. // 自动生成get、set方法
  6. ...
  7. }

然后呢？剩下的操作已经非常简单了，只需要在litepal.xml中对版本号加1就行了，如下所示：

[html] view plaincopy

  1. <litepal>
  2. <dbname value="demo" ></dbname>
  3. <version value="3" ></version>
  4. ...
  5. </litepal>

这样当我们下一次操作数据库的时候，publishdate列就应该会自动添加到comment表中。调用Connector.getDatabase()方法，然后重新查询comment表结构，如下所示：

可以看到，publishdate这一列确实已经成功添加到comment表中了。

通 过这两种升级方式的对比，相信你已经充分体会到了使用LitePal进行升级表操作所带来的便利了吧。我们不需要去编写任何与升级相关的逻辑，也不需要关 心程序是从哪个版本升级过来的，唯一要做的就是确定好最新的Model结构是什么样的，然后将litepal.xml中的版本号加1，所有的升级逻辑就都 会自动完成了。LitePal确实将数据库表的升级操作变得极度简单，使很多程序员可以从维护数据库表升级的困扰中解脱出来。

然 而，LitePal却明显做到了更好。前面我们提到过关于删除列的问题，最终的结论是无法解决，因为SQLite是不支持删除列的命令的。但是如果使用 LitePal，这一问题就可以简单地解决掉，比如说publishdate这一列我们又不想要了，那么只需要在Comment类中把它删除掉，然后将版 本号加1，下次操作数据库的时候这个列就会不见了。

那么有的朋友可能会问了，不是说SQLite不支持删除列的命令吗？那LitePal又 是怎样做到的呢？其实LitePal并没有删除任何一列，它只是先将comment表重命名成一个临时表，然后根据最新的Comment类的结构生成一个 新的comment表，再把临时表中除了publishdate之外的数据复制到新的表中，最后把临时表删掉。因此，看上去的效果好像是做到了删除列的功 能。

这也是使用框架的好处，如果没有框架的帮助，我们显然不会为了删除一个列而大废周章地去写这么多的代码，而使用框架的话，具体的实现逻辑我们已经不用再关心，只需要控制好模型类的数据结构就可以了。

另外，如果你想删除某一张表的话，操作也很简单，在litepal.xml中的映射列表中将相应的类删除，表自然也就不存在了。其它的一些升级操作也都是类似的，相信你已经能举一反三，这里就不再赘述了。

好了，今天对LitePal的介绍就到这里吧，下篇文章当中我们会学习使用LitePal来进行表关联的操作。

时间： 2024-09-30 11:19:17

Android数据库高手秘籍(三)——使用LitePal升级表的相关文章

Android数据库高手秘籍(四)——使用LitePal建立表关联

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/39207945 目前我们已经对LitePal的用法有了一定了解,学会了使用LitePal来创建表和升级表的方式,那么今天就让我们一起继续进阶,探究一下如何使用LitePal来建立表与表之间的关联关系.还没有看过前一篇文章的朋友建议先去参考 Android数据库高手秘籍(三)--使用LitePal升级表 . LitePal的项目地址是:https://github.com/LiteP

Android数据库高手秘籍(八)——使用LitePal的聚合函数

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/40614197 在上一篇文章当中,我们已经把LitePal查询操作的所有用法都学习完了,很显然,LitePal帮我们提供了非常强大的查询API,使得我们可以极度轻松地完成各种类型的查询.但是呢,在SQL语句当中,有一种查询是比较特殊的,就是聚合函数查询,它不像传统查询一样是将表中的某些列的数据查询出来,而是将查询结果进行聚合和统计,最终将统计后的结果进行返回.因此,任何一个关系型数

Android数据库高手秘籍(七)——体验LitePal的查询艺术

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/40153833 经过了多篇文章的学习,我们已经把LitePal中的绝大部分内容都掌握了.现在回想起来了,增删改查四种操作中的前三种我们都已经学完了,不知道现在使用起数据库来,你有没有感觉到格外的轻松和简单.但是呢,我们都知道,在所有的数据库操作当中,查询操作肯定是最复杂的,用法也是最多的,因此LitePal在查询方面提供的API也是比较丰富,而且LitePal在查询方面的API设计

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

经过前面几篇文章的学习,我们已经把LitePal的表管理模块的功能都很好地掌握了,相信大家都已经体会到了使用LitePal来创建表.升级 表.以及建立表关联所带来的便利.那么从本篇文章开始,我们将进入到一个新模块的学习旅程当中,使用LitePal来进行表的CRUD操作.还没有看过前 一篇文章的朋友建议先去参考 Android数据库高手秘籍(四)——使用LitePal建立表关联 . LitePal提供的CRUD操作的API还是颇为丰富的,一篇文章肯定是介绍不全的,因此这里我们仍然是分几篇文章进行讲

Android数据库高手秘籍(二)——创建表和LitePal的基本用法

文章中我们学习了一些Android数据库相关的基础知识,和几个颇为有用的SQLite命令,都是直接在命令行操作的.但是我们都知道,数据库是 要和程序结合在一起使用的,单独对一个数据库去进行増删改查操作并没有什么意义,因此今天我们就来学习一下如何在Android程序当中去操作 SQLite数据库,还没看过前一篇文章的朋友可以先去参考 Android数据库高手秘籍(一)——SQLite命令 . 操作数据库的第一步当然是创建表了,传统创建表的方法相信大多数人都知道,那么今天我除了会展示传统的建表方法之

Android数据库高手秘籍(二)：创建表和LitePal的基本用法

上一篇文章中我们学习了一些Android数据库相关的基础知识,和几个颇为有用的SQLite命令,都是直接在命令行操作的.但是我们都知道,数据库是要和程序结合在一起使用的,单独对一个数据库去进行増删改查操作并没有什么意义,因此今天我们就来学习一下如何在Android程序当中去操作SQLite数据库,还没看过前一篇文章的朋友可以先去参考Android数据库高手秘籍(一)--SQLite命令 . 操作数据库的第一步当然是创建表了,传统创建表的方法相信大多数人都知道,那么今天我除了会展示传统的建表方法之

转载-Android数据库高手秘籍(一)——SQLite命令

原文地址: http://blog.csdn.net/guolin_blog/article/details/38461239 Android数据库高手秘籍(一)——SQLite命令 分类: Android数据库高手秘籍2014-09-04 09:10 7310人阅读 评论(42) 收藏 举报 Android数据库SQLite高手秘籍LitePal 转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/38461239 要想熟练地操作任

Android数据库高手秘籍(零)——前言

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/38083103 在我刚开始接触Android的时候甚至都不敢相信,Android系统竟然是内置了数据库的!好吧,是我太孤陋寡闻了.由于我之前是从Web方向转过来的,对数据库方面的技术也是特别有偏好,当知道这一消息之后确实颇为惊喜.Android中内置的数据库是SQLite,而我之前做Web开发时最常用的数据库是MySQL,经过对比之后我发现这两个数据库极为相似,都支持标准的SQL语

Android数据库高手秘籍(一)——SQLite命令

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/38461239 要想熟练地操作任何一个数据库,最最基本的要求就是要懂SQL语言,这也是每个程序员都应该掌握的技能.虽说SQL博大精深,要想精通确实很难,但最基本的一些建表命令,增删改查,大家还是必须要学会的. SQL(Structured Query Language)是一种标准的数据库查询语言,即所有的关系型数据库都会支持它,只不过每种数据库对SQL语言的支持与标准存在着细微的不