Android—MySQLiteOpenHelper源码解读

MySQLiteOpenHelper：

直接放上源码，解读在注释里

package com.esandinfo;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;

public class MySQLiteOpenHelper extends SQLiteOpenHelper {

    public static MySQLiteOpenHelper mySQLiteOpenHelper;

    private static final String DB_NAME = "person_info.db";
    private static final int VERSION = 1;

    public synchronized static MySQLiteOpenHelper getInstance(Context context) {
        if (null == mySQLiteOpenHelper) {
            mySQLiteOpenHelper = new MySQLiteOpenHelper(context, DB_NAME, null, VERSION);
        }
        return mySQLiteOpenHelper;
    }

    /**
     * 当开发者调用 getReadableDatabase(); 或者 getWritableDatabase();
     * 就会通过此构造方法配置的信息 来创建 person_info.db 数据库
     * 所以此构造方法的配置信息，可以认为是给创建 person_info.db 数据库 准备的
     *
     * @param context 上下文
     * @param name    数据库名
     * @param factory 游标工厂
     * @param version 版本，最低为1
     */
    private MySQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
        super(context, name, factory, version);
    }

    /**
     * 此方法是何时调用? ，是需要开发者调用 getReadableDatabase(); 或者 getWritableDatabase();
     *
     * 注意：此onCreate方法只会被执行一次，因为当开发者调用 getReadableDatabase(); 或者 getWritableDatabase();
     *      是先创建好 person_info.db，然后在执行此onCreate方法，只执行一次onCreate方法
     *      所以（如果创建好 person_info.db后，onCreate方法里面的创表失败，那么一直不会执行onCreate方法了）
     *      所以（如果创建好 person_info.db后，onCreate方法里面的创表成功，那么也一直不会执行onCreate方法了）
     *      所以onCreate方法的特点是，只在 创建person_info.db后，然后执行一次onCreate方法，后续就不执行onCreate方法了
     *
     * @param db 可执行SQL语句
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        Log.d("db", "onCreate() >>>>>>>>>>>>>> ");
        db.execSQL("create table student_table(_id integer primary key autoincrement, name text, age integer);");
    }

    /**
     * 此方法用于数据库升级
     * @param db 可执行SQL语句
     * @param oldVersion 以前旧版本的版本号
     * @param newVersion 现在目前最新的版本号
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

    }


}

@Override
    public void onClick(View view) {

        MySQLiteOpenHelper mySQLiteOpenHelper = MySQLiteOpenHelper.getInstance(this);

        /**
         * 【第一次调用】
         *
         *  调用getReadableDatabase() 或者 getWritableDatabase(); 的时候，做了两件事
         *
         *  第一件事：
         *   person_info.db数据库会被创建：怎么去创建呢？
         *      答：根据SQLiteOpenHelper super(context, name, factory, version); 传递的数据库信息，然后内部创建数据库
         *
         *  第二件事：
         *   student_table表会被创建：怎么去创建呢？
         *      答：是先执行好了[第一件事] 然后马上就执行onCreate创建 student_table表；
         */

        /**
         * 【第二次调用，或者 第N此调用，反正不是第一次调用了】
         *
         *  调用getReadableDatabase() 或者 getWritableDatabase(); 的时候，做一件事
         *
         *  第一件事：
         *   person_info.db数据库会被打开？
         *      答：根据SQLiteOpenHelper super(context, name, factory, version); 传递的数据库信息，然后内部打开数据库
         *
         *  注意：由于 数据库已经存在，是不会执行onCreate方法的
         *
         */

        mySQLiteOpenHelper.getWritableDatabase();
}