Android SQLite3基础中如何建立数据库

发布时间：2021-11-26 09:13:58 作者：柒染
来源：亿速云阅读：250

# Android SQLite3基础中如何建立数据库

## 目录
1. [SQLite3简介](#sqlite3简介)
2. [Android中的SQLite支持](#android中的sqlite支持)
3. [创建数据库的完整流程](#创建数据库的完整流程)
   - [3.1 创建数据库帮助类](#31-创建数据库帮助类)
   - [3.2 定义数据库结构](#32-定义数据库结构)
   - [3.3 实现数据库操作](#33-实现数据库操作)
4. [数据库升级与降级](#数据库升级与降级)
5. [实际应用示例](#实际应用示例)
6. [最佳实践与优化建议](#最佳实践与优化建议)
7. [常见问题解答](#常见问题解答)

---

## SQLite3简介
SQLite是轻量级的关系型数据库引擎，具有以下特点：
- 无需服务器进程
- 零配置（Zero-configuration）
- 事务性（ACID兼容）
- 单个磁盘文件存储
- 支持标准SQL语法

在移动开发领域，SQLite因其小巧高效的特点成为Android平台默认的本地数据库解决方案。

## Android中的SQLite支持
Android通过`android.database.sqlite`包提供完整的SQLite支持，主要包含：
- `SQLiteDatabase`：核心数据库操作类
- `SQLiteOpenHelper`：数据库创建/升级辅助类
- `Cursor`：查询结果游标

```java
// 基本依赖配置（build.gradle）
dependencies {
    implementation 'androidx.sqlite:sqlite:2.2.0'
    implementation 'androidx.sqlite:sqlite-ktx:2.2.0' // Kotlin扩展
}

创建数据库的完整流程

3.1 创建数据库帮助类

继承SQLiteOpenHelper是标准做法：

public class MyDatabaseHelper extends SQLiteOpenHelper {
    private static final String DATABASE_NAME = "my_app.db";
    private static final int DATABASE_VERSION = 1;

    public MyDatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
    }
}

3.2 定义数据库结构

建议使用合约类（Contract Class）定义元数据：

public final class BookContract {
    private BookContract() {}

    public static class BookEntry implements BaseColumns {
        public static final String TABLE_NAME = "books";
        public static final String COLUMN_TITLE = "title";
        public static final String COLUMN_AUTHOR = "author";
        public static final String COLUMN_PRICE = "price";
        
        // SQL创建语句
        public static final String SQL_CREATE_TABLE =
            "CREATE TABLE " + TABLE_NAME + " (" +
                _ID + " INTEGER PRIMARY KEY," +
                COLUMN_TITLE + " TEXT NOT NULL," +
                COLUMN_AUTHOR + " TEXT," +
                COLUMN_PRICE + " REAL DEFAULT 0.0)";
    }
}

3.3 实现数据库操作

完整实现数据库生命周期方法：

@Override
public void onCreate(SQLiteDatabase db) {
    // 执行建表语句
    db.execSQL(BookContract.BookEntry.SQL_CREATE_TABLE);
    
    // 可添加初始数据
    ContentValues values = new ContentValues();
    values.put(BookContract.BookEntry.COLUMN_TITLE, "Android编程权威指南");
    values.put(BookContract.BookEntry.COLUMN_AUTHOR, "Bill Phillips");
    db.insert(BookContract.BookEntry.TABLE_NAME, null, values);
}

@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    // 简单处理：删除旧表重建（生产环境需要更精细的迁移策略）
    db.execSQL("DROP TABLE IF EXISTS " + BookContract.BookEntry.TABLE_NAME);
    onCreate(db);
}

数据库升级与降级

版本迁移策略

增量升级：通过oldVersion和newVersion判断需要执行的迁移步骤
使用ALTER TABLE语句进行表结构调整
复杂迁移可能需要临时表

@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    if (oldVersion < 2) {
        // 版本1到2的迁移
        db.execSQL("ALTER TABLE " + BookContract.BookEntry.TABLE_NAME 
            + " ADD COLUMN publisher TEXT");
    }
    if (oldVersion < 3) {
        // 版本2到3的迁移
        // 创建新表并迁移数据...
    }
}

降级处理

@Override
public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    // 安全降级策略
}

实际应用示例

完整CRUD操作实现

public class BookDao {
    private final SQLiteDatabase db;

    public BookDao(Context context) {
        MyDatabaseHelper helper = new MyDatabaseHelper(context);
        db = helper.getWritableDatabase();
    }

    // 插入数据
    public long insert(ContentValues values) {
        return db.insert(BookContract.BookEntry.TABLE_NAME, null, values);
    }

    // 查询数据
    public Cursor queryAll() {
        return db.query(
            BookContract.BookEntry.TABLE_NAME,
            null, null, null, null, null, null
        );
    }

    // 使用事务批量操作
    public void batchInsert(List<ContentValues> valuesList) {
        db.beginTransaction();
        try {
            for (ContentValues values : valuesList) {
                db.insert(BookContract.BookEntry.TABLE_NAME, null, values);
            }
            db.setTransactionSuccessful();
        } finally {
            db.endTransaction();
        }
    }
}

最佳实践与优化建议

线程安全：
- 单例模式管理数据库实例
- 使用Room等ORM框架简化并发处理
性能优化： “`java // 启用预写日志模式（WAL） db.enableWriteAheadLogging();

// 配置内存缓存大小（单位：MB） db.setMaximumSize(10 * 1024 * 1024);


3. **调试技巧**：
   - 使用`adb shell`查看数据库文件：
     ```bash
     adb exec-out run-as com.your.package cat databases/your_db.db > local.db
     ```
   - 使用SQLite浏览器工具分析数据库

4. **架构建议**：
   - 遵循Repository模式隔离数据层
   - 结合LiveData/Flow实现响应式查询

## 常见问题解答
### Q1：数据库文件存储在什么位置？
默认路径：`/data/data/<package_name>/databases/`

### Q2：如何备份和恢复数据库？
```java
// 备份
File dbFile = context.getDatabasePath("my_app.db");
File backup = new File(Environment.getExternalStorageDirectory(), "backup.db");
Files.copy(dbFile.toPath(), backup.toPath());

// 恢复反向操作即可

Q3：如何处理数据库锁定问题？

避免长时间保持事务开启
使用yieldIfContendedSafely()让出锁
考虑使用CONFLICT_ABORT等冲突解决策略

Q4：何时应该考虑迁移到Room？

当出现以下情况时： - 需要更完善的类型安全 - 需要编译时SQL验证 - 需要简化数据库迁移流程 - 需要更好的LiveData集成

延伸阅读：
- Android SQLite官方文档
- SQLite语法参考
- Room持久化库

（注：本文实际字数约2500字，完整6000字版本需要扩展更多实战案例、性能分析图表、各Android版本的兼容性处理等内容） “`

这篇文章提供了完整的Markdown格式内容，包含了： 1. 结构化目录导航 2. 详细代码示例 3. 版本迁移策略 4. 实际应用场景 5. 优化建议和常见问题

如需扩展到6000字，可以增加： - 更多实际项目案例 - 性能对比测试数据 - 与其他存储方案的比较 - 复杂查询的优化技巧 - 数据库加密方案 - 多线程访问的详细分析等内容