Android SQLite 开发教程(3): 创建数据库

我们将使用一个TodoList 为例介绍SQLite 的基本用法，在设计SQLite数据库表时有几点建议：

• 对于一些文件资源（如图像或是声音等）不建议直接存放在数据库表中，而今存储这些资源对应的文件名或是对于的content provider 使用的URL 全名。
• 尽管不是强制的，在设计数据库的关键字时，所有表都包含一个_id 域做为表的关键字，它是一个自动增长的整数域。 如果使用SQLite 作为一个Content Provider，此时唯一的_id域就是必须的。

设计Todolist的数据库结构如下：

前面说过Android SDK中提供了一个SQLiteOpenHelper来帮助创建，打开，和管理数据库，一个比较常见的设计模式是创建一个数据库的Adpater，为应用程序访问数据库提供一个抽象层，该层可以封装与数据库之间的直接交互：

按照上面的原则，我们为TodoList 数据库创建两个类：ToDoDBAdapter和ToDoDBOpenHelper ，其中ToDoDBOpenHelper作为ToDoDBAdapter 内部类定义（也可以作为单独类）。构造创建数据库的SQL 语句，初始的类定义如下：

public class ToDoDBAdapter {
 
private static final String DATABASE_NAME = "todoList.db";
private static final String DATABASE_TABLE = "todoItems";
private static final int DATABASE_VERSION = 1;
 
private SQLiteDatabase mDb;
private final Context mContext;
 
public static final String KEY_ID = "_id";
public static final String KEY_TASK = "task";
public static final int TASK_COLUMN = 1;
 
public static final String KEY_CREATION_DATE = "creation_date";
public static final int CREATION_DATE_COLUMN = 2;
 
private ToDoDBOpenHelper dbOpenHelper;
 
public ToDoDBAdapter(Context context) {
mContext = context;
dbOpenHelper = new ToDoDBOpenHelper(context, DATABASE_NAME, null,
DATABASE_VERSION);
}
 
public void close() {
mDb.close();
}
 
public void open() throws SQLiteException {
try {
mDb = dbOpenHelper.getWritableDatabase();
} catch (SQLiteException ex) {
mDb = dbOpenHelper.getReadableDatabase();
}
}
 
private static class ToDoDBOpenHelper extends SQLiteOpenHelper {
 
public ToDoDBOpenHelper(Context context, String name,
CursorFactory factory, int version) {
super(context, name, factory, version);
}
 
// SQL statement to create a new database
private static final String DATABASE_CREATE = "create table "
+ DATABASE_TABLE + " (" + KEY_ID
+ " integer primary key autoincrement , " + KEY_TASK
+ " text not null, " + KEY_CREATION_DATE + " long);";
 
@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL(DATABASE_CREATE);
 
}
 
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion,
int newVersion) {
Log.w("TaskDBAdapter", "Upgrading from version " + oldVersion
+ " to " + newVersion);
 
db.execSQL("DROP TABLE IF EXISTS " + DATABASE_TABLE);
onCreate(db);
 
}
 
}
 
}

ToDoDBOpenHelper 为 SQLiteOpenHelper 的子类，一般需要重载onCreate(SQLiteDatabase) 和 onUpgrade(SQLiteDabase, int ,int) 如有需要也可以重载onOpen (SQLiteDatabase), 这个类可以在数据库未创建时自动创建数据库，如果已有数据库则可以打开。

它提供了两个方法getReadableDatabase() 和getWriteableDatabase() 来取得SQLiteDatabase数据库对象，此时 SQLiteOpenHelper 会根据需要创建onCreate 或升级onUpdate 数据库，如果数据库已存在，则打开对应的数据库。 尽管是两个方法，通常两个方法返回时是同一个数据库对象，除非在出现问题时（如磁盘空间满）此时getReadableDatabase() 可能返回只读数据库对象。

ToDoDBAdapter 的open 方法首先是试图获取一个可读写的数据库对象，如果不成功，则再试图取得一个只读类型数据库。