4. SQLite原生API使用与优化

4.1 SQLiteOpenHelper 原理与生命周期

SQLiteOpenHelper 是 Android 原生 SQLite 访问的核心辅助类，封装了数据库创建、版本升级和降级逻辑。开发阶段只需继承并实现 onCreate() 和 onUpgrade()，系统会按生命周期自动调度。

public class MyDbHelper extends SQLiteOpenHelper {
    private static final String DB_NAME = "app.db";
    private static final int DB_VERSION = 1;

    public MyDbHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)");
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("DROP TABLE IF EXISTS users");
        onCreate(db);
    }
}

4.2 CRUD 操作实现

CRUD 均通过 SQLiteDatabase 对象执行，优先使用参数化查询防注入。获取数据库实例时应统一使用 getWritableDatabase()（读写）或 getReadableDatabase()（只读）。

• 增加（Insert）：ContentValues 封装字段，insert() 返回新行 ID。
• 查询（Query）：query() 或 rawQuery() 返回 Cursor。
• 更新（Update）：update() 返回受影响行数。
• 删除（Delete）：delete() 返回删除行数。

// 插入
ContentValues cv = new ContentValues();
cv.put("name", "Alice");
cv.put("age", 28);
long newId = db.insert("users", null, cv);

// 查询
Cursor cursor = db.query("users", null, "age > ?", new String[]{"20"}, null, null, "age DESC");
while (cursor.moveToNext()) {
    String name = cursor.getString(cursor.getColumnIndexOrThrow("name"));
    int age = cursor.getInt(cursor.getColumnIndexOrThrow("age"));
}
cursor.close();

// 更新
ContentValues updateCv = new ContentValues();
updateCv.put("age", 29);
int rows = db.update("users", updateCv, "name = ?", new String[]{"Alice"});

// 删除
int deleted = db.delete("users", "id = ?", new String[]{"1"});

4.3 事务管理与 ACID 保障

事务保证多步操作原子性、一致性、隔离性和持久性。Android SQLiteDatabase 提供 beginTransaction()/setTransactionSuccessful()/endTransaction() 机制，支持嵌套事务（Savepoint）。

SQLiteDatabase db = dbHelper.getWritableDatabase();
try {
    db.beginTransaction();
    // 批量操作
    db.insert(...);
    db.update(...);
    db.setTransactionSuccessful();
} finally {
    db.endTransaction(); // 未调用 setSuccessful() 时会自动回滚
}

4.4 批量插入性能调优

大量插入（如首次安装导入、数据同步）时逐条插入极其低效。优化方案对比：

推荐使用 SQLiteStatement 预编译 + 显式事务：

SQLiteDatabase db = dbHelper.getWritableDatabase();
String sql = "INSERT INTO users (name, age) VALUES (?, ?)";
db.beginTransaction();
try (SQLiteStatement stmt = db.compileStatement(sql)) {
    for (User user : userList) {
        stmt.bindString(1, user.getName());
        stmt.bindLong(2, user.getAge());
        stmt.executeInsert();
        stmt.clearBindings();
    }
    db.setTransactionSuccessful();
} finally {
    db.endTransaction();
}

4.5 查询游标管理

Cursor 代表查询结果集行指针，必须及时关闭以避免 CursorWindow 泄漏。管理原则：

• 获取游标后尽快将数据读入内存（如 List），然后关闭游标。
• 禁止跨 Activity/Fragment 传递 Cursor，改用 Parcelable 或 ContentProvider。
• 使用 try-with-resources 或 finally 确保关闭。

Cursor cursor = null;
try {
    cursor = db.rawQuery("SELECT * FROM users WHERE age > ?", new String[]{"18"});
    while (cursor.moveToNext()) {
        // 读取数据
    }
} finally {
    if (cursor != null && !cursor.isClosed()) {
        cursor.close();
    }
}