SQLite 特性回顧
- 嵌入式、零配置、單文件、ACID 事務、SQL-92 大部分支持。
- 動態弱類型:列類型為類型親和性,任意值可存入任意列 (字符串可存 INTEGER 列)。
- 不支持:外鍵約束 (默認關閉,
PRAGMA foreign_keys=ON 啟用)、RIGHT/FULL OUTER JOIN、完整 ALTER TABLE (僅 RENAME/ADD COLUMN)。
Android 集成架構
- 運行時內置 SQLite (~3.5MB),每個 App 獨立數據庫文件:
/data/data//databases/.db
- 無 JDBC (過重),提供輕量 API:
SQLiteDatabase、SQLiteOpenHelper、Cursor、ContentValues。
- 跨進程共享需通過 ContentProvider。
SQLiteOpenHelper 標準模式
public class DbHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "app.db";
private static final int DB_VERSION = 1;
// 建表 SQL
private static final String CREATE_USER_TABLE =
"CREATE TABLE user (_id INTEGER PRIMARY KEY AUTOINCREMENT, " +
"name TEXT NOT NULL, email TEXT UNIQUE, age INTEGER, created_at INTEGER DEFAULT (strftime('%s','now')))";
public DbHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION); // cursorFactory 通常傳 null
}
@Override public void onCreate(SQLiteDatabase db) {
db.execSQL(CREATE_USER_TABLE);
db.execSQL("CREATE INDEX idx_user_email ON user(email)");
// 初始化基礎數據
ContentValues cv = new ContentValues();
cv.put("name", "Admin"); cv.put("email", "admin@example.com"); cv.put("age", 30);
db.insert("user", null, cv);
}
@Override public void onUpgrade(SQLiteDatabase db, int oldV, int newV) {
// 版本遷移:逐版本升級或重建
if (oldV < 2) {
db.execSQL("ALTER TABLE user ADD COLUMN phone TEXT");
}
if (oldV < 3) {
db.execSQL("CREATE TABLE profile (...)"); // 新表
}
}
@Override public void onOpen(SQLiteDatabase db) {
super.onOpen(db);
if (!db.isReadOnly()) db.execSQL("PRAGMA foreign_keys=ON"); // 啟用外鍵
}
}
CRUD 核心操作
// 獲取可寫/讀實例 (同一對象,區別在於磁盤滿時行為)
SQLiteDatabase db = dbHelper.getWritableDatabase(); // 或 getReadableDatabase()
// Insert
ContentValues values = new ContentValues();
values.put("name", "Alice"); values.put("email", "alice@example.com"); values.put("age", 25);
long newRowId = db.insert("user", null, values); // 返回 _id 或 -1
// Query (推薦 query 方法防注入)
Cursor cursor = db.query(
"user", // table
new String[]{"_id","name","email","age"}, // columns
"age > ?", new String[]{"18"}, // selection + args
null, null, null, "name ASC" // groupBy, having, orderBy, limit
);
while (cursor.moveToNext()) {
long id = cursor.getLong(0);
String name = cursor.getString(1);
// ...
}
cursor.close(); // 必須關閉!
// Update
ContentValues upd = new ContentValues(); upd.put("age", 26);
int count = db.update("user", upd, "_id=?", new String[]{String.valueOf(id)});
// Delete
int deleted = db.delete("user", "_id=?", new String[]{String.valueOf(id)});
// 原始 SQL (靈活但防注入)
db.execSQL("UPDATE user SET age=age+1 WHERE email LIKE ?", new Object[]{"%@example.com"});
Cursor raw = db.rawQuery("SELECT * FROM user WHERE age BETWEEN ? AND ?", new String[]{"18","30"});
進階主題
事務管理
db.beginTransaction();
try {
db.insert(...); db.update(...); db.delete(...);
db.setTransactionSuccessful();
} finally {
db.endTransaction();
}
Cursor 適配器綁定 ListView/RecyclerView
SimpleCursorAdapter adapter = new SimpleCursorAdapter(
this, R.layout.item, cursor,
new String[]{"name","email"}, new int[]{R.id.tvName, R.id.tvEmail}, 0);
listView.setAdapter(adapter);
// 數據變更後
adapter.changeCursor(newCursor); // 記得關閉舊 Cursor
數據庫遷移最佳實踐
- 版本號單調遞增,
onUpgrade 編寫冪等遷移腳本。
- 複雜遷移:重建表 → 複製數據 → 刪舊表 → 重命名。
- 考慮 Room (Jetpack) — 編譯時 SQL 驗證、LiveData/Flow 觀察、自動遷移測試、Paging 整合,**現代首選 ORM**。
調試技巧
adb shell → sqlite3 /data/data/pkg/databases/app.db 進入交互式控制台。
- Android Studio **Database Inspector** (Arctic Fox+) 圖形化查看/編輯/執行 SQL。
db.enableWriteAheadLogging() (WAL 模式) 提升併發讀寫性能 (API 16+)。