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地址