Android之SQLiteOpenHelper

---

一、SQLiteOpenHelper概念

Android平台里一个数据库辅助类，用来创建或打开数据库，并且管理数据库的创建和版本更新

(抽象类，通常适用于数据库的创建，表的创建以及数据库的升级操作，我们还可以通过该类的对象获得数据库实例，或者关闭数据库)

---

二、实例方法

获取数据库实例

1、SQLiteDatabase db = helper.getReadableDatabase();

2、SQLiteDatabase db = helper.getWritableDatabase();

①数据库存在，则直接打开数据库
②数据库不存在，则创建数据库，再打开数据库
③数据库存在，但版本号升高了，则调用数据库升级方法

3、区别
当数据库不可写入的时候*如磁盘空间已满），getReadableDatabase()返回的对象将以只读的方式去打开数据库，二而getWritableDatabase()将出现异常

---

三、构造方法

SQLiteOpenHelper类的构造方法格式为

public SQLiteOpenHelper(Context context,
                        String name,
                        SQLiteDatabase.CursorFactory factory,
                        int version)

参数1：context表示用来打开或创建数据据的上下文；
参数2：name指定了数据库文件；
参数3：factory用来创建cursor对象，如果使用默认的factory，则将该参数设置为null；
参数4：version表示数据库的版本号，该版本号从1开始依次递增

---

四、需要重写的两个方法（回调方法）

SQLiteOpenHelper helper=new SQLiteOpenHelper(this,path,null,2) {
    @Override
    public void onCreate(SQLiteDatabase db) {
       
       ... ...
       
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        
       ... ...

    }
};

1、onCreate()

@Override
public void onCreate(SQLiteDatabase db) {
 
 	... ...
 
}

当数据库文件被首次创建时会调用该函数，也就是在调用SQLiteOpenHelper类的getWritableDatabase()或者getReadableDatabase()时会调用该方法。

我的理解：
这是一个回调方法，在数据库文件未创建，且调用了SQLiteOpenHelper类的getWritableDatabase()或者getReadableDatabase()（返回值类型是SQLiteDatabase）时，会回调onCreate()方法（传入的参数db就是前面的返回值），在该方法中进行数据库文件的创建。

在该方法中主要完成数据库表的创建

---

2、onUpgrade()

 @Override
 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
     
    ... ...

 }

这也是一个回调方法。当数据库需要更新的时候调用该方法。可以通过该方法实现删除表、添加表或者更新表

---

3、示例

String path= Environment.getExternalStorageDirectory()+"/test.sql";
SQLiteOpenHelper helper=new SQLiteOpenHelper(this,path,null,2) {
    @Override
    /**
     * onCreate是一个回调方法，它的执行在数据库不存在，并且已经helper.getReadableDatabase()的情况下
     * 才会调用onCreate方法,会将返回的SQLiteDatabase对象传回到onCreate中
     */
    public void onCreate(SQLiteDatabase db) {

        // 创建
        Toast.makeText(MainActivity2.this, "数据库创建", Toast.LENGTH_SHORT).show();

        /**
         * 数据库不存在，则会调用onCreate方法，那么我们可以将表的创建工作放在这里完成
         */
        //SQL语句
        String sql = "create table test_tab(_id integer primary key autoincrement,name varchar(20),age integer,gender varchar)";
        db.execSQL(sql);

    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // 升级
        Toast.makeText(MainActivity2.this,"数据库升级",Toast.LENGTH_SHORT).show();

        }
};

//用于获取数据库对象
db = helper.getReadableDatabase();