SQLite 数据库存储

一、创建数据库

---

1. SQLiteOpenHelper 帮助类

1. SQLiteOpenHelper 是一个抽象类，想要使用它的话，就需要创建一个自己的帮助类去继承它。并复写两个抽象方法：

• onCreate()：创建时执行，已经存在不执行。
• onUpgrade()：版本号不同时执行。

2. 两个重要的实例方法 **getReadableDatabase() **和 getWritableDatabase()。

• 这两个方法都可以创建或打开一个现有的数据库（如果数据库已存在则直接打开，否则创建一个新的数据库）。
• 并返回一个可对数据库进行读写操作的对象。
• 不同处。当数据库不可写入时（如磁盘空间已满）getReadableDatabase() 方法返回的对象将以只读的方式去打开数据库，而 getWritableDatabase() 方法则将出现异常。

3. SQLiteOpenHelper 中有两个构造方法可供重写，一般使用参数少一点的那个构造方法即可。

• 第一个参数：Context。
• 第二个参数：数据库名。
• 第三个参数：查询数据的时候返回一个自定义的 Cursor，一般传入null。
• 第四个参数：当前数据库的版本号。

2. 创建数据库步骤

1. 构建出** SQLiteOpenHelper 实例**。
2. 再调用它的 getReadableDatabase() 或** getWritableDatabase() **方法就能够创建数据库了。
3. 数据库文件会存放在 **/data/data/<package name>/databases/ **目录下。
4. 此时，重写的** onCreate() **方法也会得到执行

3. 示例

希望创建一个名为 BookStore.db 的数据库，然后在这个数据库中新建一张 Book 表，表中有 id（主键）、作者、价格、页数和书名等列。

建表语句如下：

create table Book (
    id integer primary key autoincrement,
    author text,
    price real,
    pages integer,
    name text)

用 primary key 将 id 列设为主键，并用 autoincrement 关键字表示 id 列是自增长的。

public class MyDatabaseHelper extends SQLiteOpenHelper {
    public static final String CREATE_BOOK = "create table book ("
        + "id integer primary key autoincrement, "
        + "author text, "
        + "price real, "
        + "pages integer, "
        + "name text)";

    private Context mContext;

    public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {
        super(context, name, factory, version);
        mContext = context;
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
        Toast.makeText(mContext, "Create succeeded", Toast.LENGTH_SHORT).show();
    }

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

    }
}

dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 1);
dbHelper.getWritableDatabase();

4. 查看数据库

1. 打开命令行，输入 adb shell。
2. 使用 cd 命令进到/data/data/<package name>/databases/ 目录下。
3. 键入 sqlite3，后面加上数据库名，打开数据库。
4. 键入 .table 命令，查看目前数据库中有哪些表。
5. 键入 .schema 命令来查看它们的建表语句。
6. 键入 .exit 或 .quit 命令退出数据库的编辑。
7. 键入 select * from 表名； 命令查看表。

---

二、升级数据库

---

想再添加一张 Category 表用于记录书籍的分类，包括 id（主键）、分类名和分类代码这几个列。

建表语句如下：

create table Category (
    id integer primary key autoincrement,
    category_name text,
    category_code integer)

public static final String CREATE_CATEGORY = "create table Category ("
    + "id integer primary key autoincrement, "
    + "category_name text, "
    + "category_code integer)";

更改版本号，执行 onUpgrade() 升级数据库：

dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2);

---

三、升级数据库的最佳写法

---

1. 第一版数据库

public class MyDatabaseHelper extends SQLiteOpenHelper {
    public static final String CREATE_BOOK = "create table Book ("
        + "id integer primary key autoincrement, "
        + "author text, "
        + "price real, "
        + "pages integer, "
        + "name text)";

    public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {
        super(context, name, factory, version);
    }

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

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

    }
}

2. 第二版，需要向数据库中再添加一张 Category 表

public class MyDatabaseHelper extends SQLiteOpenHelper {
    public static final String CREATE_BOOK = "create table Book ("
        + "id integer primary key autoincrement, "
        + "author text, "
        + "price real, "
        + "pages integer, "
        + "name text)";

    public static final String CREATE_CATEGORY = "create table Category ("
        + "id integer primary key autoincrement, "
        + "category_name text, "
        + "category_code integer)";

    public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {
        super(context, name, factory, version);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
        db.execSQL(CREATE_CATEGORY);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        switch (oldVersion) {
            case 1:
                db.execSQL(CREATE_CATEGORY);
            default:
        }
    }
}

1. 通过判断旧版本号选择。
2. 如果直接第二版，就执行 onCreate() 两个表都创建。
3. 如果第一版升级第二版，执行 onUpgrade() 的 case 1，只创建新表。

3. 第三版，需要在 Book 表中添加一个 category_id 的字段

public class MyDatabaseHelper extends SQLiteOpenHelper {
    public static final String CREATE_BOOK = "create table Book ("
        + "id integer primary key autoincrement, "
        + "author text, "
        + "price real, "
        + "pages integer, "
        + "name text, "
        + "category_id integer)";

    public static final String CREATE_CATEGORY = "create table Category ("
        + "id integer primary key autoincrement, "
        + "category_name text, "
        + "category_code integer)";

    public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {
        super(context, name, factory, version);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
        db.execSQL(CREATE_CATEGORY);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        switch (oldVersion) {
            case 1:
                db.execSQL(CREATE_CATEGORY);
            case 2:
                db.execSQL("alter table Book add column category_id integer");
            default:
        }
    }
}

• 根据不同版本号，执行不同的更新操作。
• 注意，switch 中每一个 case 的最后都是没有使用 break 的。
  这是为了保证在跨版本升级的时候，每一次的数据库修改都能被全部执行到。