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

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

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

传统的升级表方式

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

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

public class MySQLiteHelper extends SQLiteOpenHelper {
     
    public static final String CREATE_NEWS = "create table news ("
            + "id integer primary key autoincrement, "
            + "title text, "
            + "content text, "
            + "publishdate integer,"
            + "commentcount integer)";
     
    public static final String CREATE_COMMENT = "create table comment ("
            + "id integer primary key autoincrement, "
            + "content text)";
 
    public MySQLiteHelper(Context context, String name, CursorFactory factory,
            int version) {
        super(context, name, factory, version);
    }
 
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_NEWS);
        db.execSQL(CREATE_COMMENT);
    }
 
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    }
 
}

这对于第一次安装咱们软件的用户来讲是彻底能够正常工做的，可是若是有的用户已经安装过上一版的软件，那么很遗憾，comment表是建立不出来的，由于以前数据库就已经建立过了，onCreate()方法是不会从新执行的。

 

对于这种状况咱们就要用升级的方式来解决了，看到MySQLiteHelper构造方法中的第四个参数了吗，这个就是数据库版本号的标识，每当版本号增长的时候就会调用onUpgrade()方法，咱们只须要在这里处理升级表的操做就好了。比较简单粗暴的方式是将数据库中现有的全部表都删除掉，而后从新建立，代码以下所示：

public class MySQLiteHelper extends SQLiteOpenHelper {
     
    ......
 
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_NEWS);
        db.execSQL(CREATE_COMMENT);
    }
 
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("drop table if exists news");
        onCreate(db);
    }
 
}

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

 

可是，若是news表中原本已经有数据了，使用这种方式升级的话，就会致使表中的数据所有丢失，因此这并非一种值得推荐的升级方法。那么更好的升级方法是什么样的呢？这就稍微有些复杂了，须要在onUpgrade()方法中根据版本号加入具体的升级逻辑，咱们来试试来吧。好比以前的数据库版本号是1，那么在onUpgrade()方法中就能够这样写：

public class MySQLiteHelper extends SQLiteOpenHelper {
 
    ......
 
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_NEWS);
        db.execSQL(CREATE_COMMENT);
    }
 
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        switch (oldVersion) {
        case 1:
            db.execSQL(CREATE_COMMENT);
        default:
        }
    }
 
}

能够看到，这里在onUpgrade()方法中加入了一个switch判断，若是oldVersion等于1，就再建立一个comment表。如今只须要调用以下代码，表就能够获得建立或升级了：

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

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

 

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

public class MySQLiteHelper extends SQLiteOpenHelper {
 
    ......
 
    public static final String CREATE_COMMENT = "create table comment ("
            + "id integer primary key autoincrement, "
            + "content text, "
            + "publishdate integer)";
 
    ......
 
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        switch (oldVersion) {
        case 1:
            db.execSQL(CREATE_COMMENT);
            break;
        case 2:
            db.execSQL("alter table comment add column publishdate integer");
            break;
        default:
        }
    }
 
}

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

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

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

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

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

使用LitePal升级表

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

package com.example.databasetest.model;
 
public class Comment {
     
    private int id;
     
    private String content;
     
    // 自动生成get、set方法 
    ...
}

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

 

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

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

没错，就是这么简单，仅仅两步，升级的操做就已经完成了，如今咱们只须要操做一下数据库，comment表就会自动生成了，以下所示：

SQLiteDatabase db = Connector.getDatabase();

那么咱们仍是经过.table命令来查看一下结果，以下图所示：

 

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

 

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

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

public class Comment {
     
    private int id;
     
    private String content;
     
    private Date publishDate;
     
    // 自动生成get、set方法 
    ...
}

而后呢？剩下的操做已经很是简单了，只须要在litepal.xml中对版本号加1就好了，以下所示：

<litepal>
    <dbname value="demo" ></dbname>
 
    <version value="3" ></version>
    ...
</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来进行表关联的操做。