SQLite 数据库使用

概述

在项目的开发过程中,有很多功能都需要我们将数据保存到我们的手机本地来提升app的性能,常见的有图片缓存、消息的离线缓存等;
Android端常见的本地数据缓存方式有:

  1. SharedPreference:缓存轻量级的 key-value 类型的数据,例如:账号、密码等;
  2. File:用来存储文件,例如:图片,音乐等;
  3. SQLite:用来存储大量复杂的关系型数据;

我们知道现在的app都是数据量比较大的,例如我们每天使用的qq,少的来说也有几百条消息记录,多的有可能是上万条的消息数据,如果我们使用 SharedPreference 或者 File 来存储显然是不合适的,这时候就应该轮到SQLite数据库上场了;


@A@

本片文章着重讲的是如何使用,关于 SQLite 的概念大家可以自己去找资料;

关于SQLiteOpenHelper的使用

Android 官方帮我们封装了一个SQLiteOpenHelper类来帮助我们操作数据库;我们只需要写一个类继承它,重写抽象方法即可;

public class DbOpenHelper extends SQLiteOpenHelper {

    public static DbOpenHelper mInstance;

    private DbOpenHelper() {
        super(AppApplication.mContext, getUserDatabaseName(), null, Constant.DATABASE_VERSION);
    }

    /**
     * @param context 我们可以使用ApplicationContext,因此我们在设计单例的时候可以设置成无参
     * @param name    创建的数据库的名称
     * @param factory 游标工厂,直接传入null就好
     * @param version 创建的数据库版本 >= 1
     */
    private DbOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
        super(context, name, factory, version);
    }


    public static DbOpenHelper getInstance() {
        if (mInstance == null) {
            synchronized (DbOpenHelper.class) {
                if (mInstance == null) {
                    mInstance = new DbOpenHelper();
                }
            }
        }
        return mInstance;
    }

    /**
     * 当数据库创建(db文件)的时候调用(此处我们执行当前版本所有的表的创建语句)
     *
     * @param db 数据库对象
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        Log.e("TAG", "-----onCreate-----");
    }

    /**
     * 当数据库有版本更新的时候调用,在这里我们根据不同的版本对数据库进行相关修改
     *
     * @param db         数据库对象
     * @param oldVersion 数据库旧版本
     * @param newVersion 数据库更新
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        Log.e("TAG", "-----onUpgrade-----");
    }

    /**
     * 拼接生成不同的db文件(如果是IM项目,不同的账号登录应该对应不同的db文件)
     *
     * @return
     */
    private static String getUserDatabaseName() {
        return Constant.DATABASE_NAME + "_demo.db";
    }
    
}

相关方法的解析大家可以查看注释,还是比较容易理解的,这里我们需要注意的是默认的数据库db文件保存的位置为 /data/data/'项目包名'/databases/***.db,如果使用模拟器测试,最好将模拟器版本控制在5.0及以下,这样可以直接查看文件,否则需要自己修改权限;

DbManager 管理/执行 sql 语句

在打开了数据库后,通常我们会再建立一个数据库管理工具类 DbManager,来管理和执行我们的业务相关的SQL,这样有助于我们管理项目,同样我们可以将其设置为单例模式,我们在DbManager类中,通过我们自己定义的DbOpenHelper类,调用getWritableDatabase()或者getReadableDatabase()方法,拿到数据库读写操作的SQLiteDatabase对象来执行SQL语句,个人比较推荐大家使用sql语句,DbManager 类里面就是一些数据的增删改查的方法,这里就不贴代码了,在文章的末尾会给出项目的github地址;
还有一点就是数据库的名称、字段名称在sql语句中出现的频率非常的高,这里推荐大家给不同的表都建立一个 Dao 类,将 数据库的表名称,字段名称写成静态成员变量的形式,这样可以避免我们在写 sql 语句的时候发生数据库表名称、字段名称拼写错误的问题,同时我们可以在此类里面写入对应表的增删改查操作(实际还是引用DbManager类里面的方法),在具体的业务的地方,直接调用此对象,这样也可以让我们的代码更加明确,例如:

public class UserDao {

    // 将数据库表中的相关字段名称定义到这里,防止拼写错误
    public static final String TABLE_NAME = "users";

    public static final String COLUMN_NAME_ID = "id";
    public static final String COLUMN_NAME_USER = "user_name";
    public static final String COLUMN_NAME_PASSWORD = "password";
    public static final String COLUMN_NAME_EMAIL = "email";

    public void insert(User user) {
        DbManager.getInstance().insertUser(user);
    }

    public ArrayList<User> selectAll() {
        return DbManager.getInstance().selectAllUsers();
    }

    public void updateByName(User user) {
        DbManager.getInstance().updateUserByName(user);
    }

    public void deleteByUserName(String userName) {
        DbManager.getInstance().deleteUserByName(userName);
    }

}

关于db文件

类似IM之类的app,通常表的结构是已经拟定好了的,用于区分不同账号的最好的方式就是根据登录的用户,创建单独的db文件,因为SQLiteOpenHelper 类打开的是一个db文件,在用户登录的时候判断创建/打开具体的db文件:

db文件

具体的写法可以参考上面类中的 getUserDatabaseName() 方法;

关于数据库的版本更新

随着业务改变,应用的版本也在更新,如果在业务更新的同时,数据库表的数据结构发生了修改,或者增加了新表(通常只有增加表或字段,基本不会删除表和字段),我们需要将我们的数据库的版本往上增加,此时:

  1. 新用户:调用 onCreate 方法,在此方法内完成数据库表的创建;
  2. 旧版本用户: 调用 onUpgrade 方法,在此方法内判断旧版的数据库版本,然后逐版本的更新数据库中的表,直至更新到当前新安装的数据库的版本;


    @A@
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    Log.e("TAG", "-----onUpgrade-----");

    if (oldVersion < 2) {
        // 删除原来的表,新建数据库表(基本不会有此操作)
        String sql = "drop table user";
        db.execSQL(sql);
        db.execSQL(USER_CREATE_TABLE);
    }
    if (oldVersion < 3) {
        // 增加列
        Log.e("TAG", "-----------onUpgrade--------- 增加 email 列");
        String sql = "alter table " + UserDao.TABLE_NAME + " add " + UserDao.COLUMN_NAME_EMAIL + " text";
        db.execSQL(sql);
    }

    if (oldVersion < 4) {
        // 删除列(基本不会有此操作)
        // SQLite不支持删除列操作,需要进行以下操作来完成
        Log.e("TAG", "-----------onUpgrade--------- 删除 password 列");
        // 1.创建一张临时表
        String sql = "create table temp as select " + UserDao.COLUMN_NAME_ID + ", " + UserDao.COLUMN_NAME_USER + ", " + UserDao.COLUMN_NAME_EMAIL + " from " + UserDao.TABLE_NAME + " where 1 = 1";
        db.execSQL(sql);
        // 2.删除原来的表
        sql = "drop table " + UserDao.TABLE_NAME;
        db.execSQL(sql);
        // 3.修改临时表的名称
        sql = "alter table temp rename to " + UserDao.TABLE_NAME;
        db.execSQL(sql);

    }

    if (oldVersion < 5) {
        // 增加表
        Log.e("TAG", "-----------onUpgrade--------- 增加表 performance");
        db.execSQL(PERFORMANCE_CREATE_TABLE);
        String sql = "insert into " + PerformanceDao.TABLE_NAME + "(" + PerformanceDao.COLUMN_NAME_USER_ID + ", " + PerformanceDao.COLUMN_NAME_SALARY + ") values(1, 20.00)";
        db.execSQL(sql);
    }

}

总结

本案例主要还是偏向于SQLite数据库的使用而不是原理解析,主要是想先知其然,然后知其所以然,如果想要深入了解的,大家可以google下,这方面的资料还是比较多的;
其实Android中SQLite用起来还是比较简单的,不需要向Java中其它数据库连接使用jdbc一样,直接通过 SQLiteOpenHelper 类就可以帮助我们很快速的进行操作数据库;

项目的github地址

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

推荐阅读更多精彩内容