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

在上一篇文章中,我们学习了LitePal框架来进行创建表操作的便利。我们在一开始创建的表结构,随着需求的变更,到了后期是极有可能需要修改的。升级表的操作对于任何一个项目也是至关重要的,今天我们一起来学习,Android传统开发当中升级表,以及使用LitePal来升级表。没看过前一篇文章,建议先去参考一下 Android数据库高手(二)创建表和LitePal创建表

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

mini_logo.png

传统的升级表方式

上一篇文章中借助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");
                db.execSQL("drop table if exists comment");
        onCreate(db);
    }
 
}

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

如果news表中本来已经有数据了,使用这种方式升级会导致表中的数据全部丢失,更好的升级方法是什么样的呢?咱么一会通过LitePal就可以轻松解决这个问题,给力了我的哥。

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

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

使用LitePal升级表

已经熟悉LitePal创建表流程的你,相信对于升级表也一定会轻车熟路的。现在我们也需要创建一张comment表。第一步该怎么办呢?相信你也许早就已经猜到了,那当然是先创建一个Comment类了,如下所示:

package com.example.sqlitefeel.bean;

public class Comment {

    private int id;
    private String content;
    // 自动生成get、set方法
}

Comment类中有id和content这两个字段,也就意味着comment表中会有id和content这两列。
接着修改litepal.xml中的配置,在映射列表中新增Cooment类,并将版本号加1,如下所示:

<?xml version="1.0" encoding="utf-8"?>
<litepal>
    <dbname value="demo" />

    <version value="2" />

    <list>
        <mapping class="com.example.sqlitefeel.bean.News"></mapping>
        <mapping class="com.example.sqlitefeel.bean.Comment"></mapping>
    </list>
</litepal>

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

SQLiteDatabase db = Connector.getDatabase();

那么我们还是通过.table命令来查看一下结果,如下图所示:
(不熟悉SQLite命令的小伙伴先熟悉下)[//www.greatytc.com/p/d35d0b82eeff
]

sqlite> .table
android_metadata  comment           news              table_schema

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

sqlite> pragma table_info(comment);
0|id|integer|0||1
1|content|text|0||0

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表结构,如下所示:

sqlite> pragma table_info(comment);
0|id|integer|0||1
1|content|text|0||0
2|publishdate|integer|0||0

咱么换种显示方式 .mode line(以换行的方式显示)

sqlite> pragma table_info(comment);
       cid = 0
      name = id
      type = integer
   notnull = 0
dflt_value =
        pk = 1

       cid = 1
      name = content
      type = text
   notnull = 0
dflt_value =
        pk = 0

       cid = 2
      name = publishdate
      type = integer
   notnull = 0
dflt_value =
        pk = 0

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

我们不需要去编写任何与升级相关的逻辑,也不需要关心程序是从哪个版本升级过来的,唯一要做的就是确定好最新的Model结构是什么样的,然后将litepal.xml中的版本号加1,所有的升级逻辑就都会自动完成了。LitePal确实将数据库表的升级操作变得极度简单,使很多程序员可以从维护数据库表升级的困扰中解脱出来。

比如说publishdate这一列我们又不想要了,那么只需要在Comment类中把它删除掉,然后将版本号加1,下次操作数据库的时候这个列就会不见了。

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

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

下篇文章当中我们会学习使用LitePal来进行表关联的操作,感兴趣的朋友请继续阅读 Android数据库高手秘籍(四)——LitePal建立表关联 //www.greatytc.com/p/df0c52c1a771

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,204评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,091评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,548评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,657评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,689评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,554评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,302评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,216评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,661评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,851评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,977评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,697评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,306评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,898评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,019评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,138评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,927评论 2 355

推荐阅读更多精彩内容

  • 简述 LitePal是郭神(郭霖)在2014年的杰作,三年后在github上有了一个更新,故来学习一番,没想到还挺...
    努力深耕Android的小透明阅读 886评论 2 7
  • 因为我们无法预料未来, 所以才会产生迷茫和恐惧。 因为我们无法预料未来, 所以才会收获惊喜与期待。
    凡声尘语阅读 197评论 1 2
  • 昨天看了电影《老师好》,真心不错,推荐大家都去观看。通过观看影片,深刻感受到一个好老师的不平凡事迹。 带有20世纪...
    暖暖_075f阅读 193评论 0 0
  • 类加载 在java代码中,类型的加载、连接与初始化过程都是在程序运行期间完成的提供了更大的灵活性,增加了更多的可能...
    small瓜瓜阅读 106评论 0 0
  • 文/浅茉轻语 『1』 中午,阳光正好。 缕缕暖光照耀在地面上,泛着微黄的光晕,走出门来,感觉空气都...
    字若黎光阅读 263评论 0 26