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 陳述式，初始的類定義如下：

[java]
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); 
  
} 
  
} 
  
} 
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 方法首先是試圖擷取一個可讀寫的資料庫物件，如果不成功，則再試圖取得一個唯讀類型資料庫。

 

 

摘自 引路蜂移動軟體