萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android SQLite 數據庫開發實戰:SQLiteOpenHelper 模式、CRUD 操作與最佳實踐

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+)。
copyright © 萬盛學電腦網 all rights reserved