一、创建数据库
1. SQLiteOpenHelper 帮助类
- SQLiteOpenHelper 是一个抽象类,想要使用它的话,就需要创建一个自己的帮助类去继承它。并复写两个抽象方法:
- onCreate():创建时执行,已经存在不执行。
- onUpgrade():版本号不同时执行。
- 两个重要的实例方法 **getReadableDatabase() **和 getWritableDatabase()。
- 这两个方法都可以创建或打开一个现有的数据库(如果数据库已存在则直接打开,否则创建一个新的数据库)。
- 并返回一个可对数据库进行读写操作的对象。
- 不同处。当数据库不可写入时(如磁盘空间已满)getReadableDatabase() 方法返回的对象将以只读的方式去打开数据库,而 getWritableDatabase() 方法则将出现异常。
- SQLiteOpenHelper 中有两个构造方法可供重写,一般使用参数少一点的那个构造方法即可。
- 第一个参数:Context。
- 第二个参数:数据库名。
- 第三个参数:查询数据的时候返回一个自定义的 Cursor,一般传入null。
- 第四个参数:当前数据库的版本号。
2. 创建数据库步骤
- 构建出** SQLiteOpenHelper 实例**。
- 再调用它的 getReadableDatabase() 或** getWritableDatabase() **方法就能够创建数据库了。
- 数据库文件会存放在 **/data/data/<package name>/databases/ **目录下。
- 此时,重写的** 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. 查看数据库
- 打开命令行,输入 adb shell。
- 使用 cd 命令进到/data/data/<package name>/databases/ 目录下。
- 键入 sqlite3,后面加上数据库名,打开数据库。
- 键入 .table 命令,查看目前数据库中有哪些表。
- 键入 .schema 命令来查看它们的建表语句。
- 键入 .exit 或 .quit 命令退出数据库的编辑。
- 键入 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 的。
这是为了保证在跨版本升级的时候,每一次的数据库修改都能被全部执行到。