在安卓应用开发中,数据持久化是至关重要的一环，SQLite作为安卓内置的轻量级关系型数据库，因其无需服务器、资源占用低、功能完整等特点，成为了本地数据存储的首选方案，本文将详细阐述如何在安卓应用中创建和打开一个SQLite数据库文件，并介绍如何便捷地查看数据库内容。
创建数据库文件
安卓系统推荐使用SQLiteOpenHelper这个抽象辅助类来管理数据库的创建和版本更新，它封装了创建和打开数据库的复杂逻辑，让开发者可以更专注于SQL操作。
要创建数据库,你需要创建一个继承自SQLiteOpenHelper的自定义类，在这个类中，你需要重写两个核心方法：onCreate()和onUpgrade()。
创建自定义Helper类
以下是一个使用Kotlin编写的DatabaseHelper示例：
import android.content.Context
import android.database.sqlite.SQLiteDatabase
import android.database.sqlite.SQLiteOpenHelper
class DatabaseHelper(context: Context) : SQLiteOpenHelper(context, DATABASE_NAME, null, DATABASE_VERSION) {
companion object {
private const val DATABASE_VERSION = 1
private const val DATABASE_NAME = "MyDatabase.db"
private const val TABLE_NAME = "users"
private const val COLUMN_ID = "id"
private const val COLUMN_NAME = "name"
}
// 在数据库首次创建时调用
override fun onCreate(db: SQLiteDatabase?) {
val createTableQuery = (
"CREATE TABLE $TABLE_NAME (" +
"$COLUMN_ID INTEGER PRIMARY KEY AUTOINCREMENT," +
"$COLUMN_NAME TEXT NOT NULL" +
")"
)
db?.execSQL(createTableQuery)
}
// 当数据库版本号增加时调用，用于升级数据库
override fun onUpgrade(db: SQLiteDatabase?, oldVersion: Int, newVersion: Int) {
// 简单的策略：删除旧表并重新创建
db?.execSQL("DROP TABLE IF EXISTS $TABLE_NAME")
onCreate(db)
}
} 理解核心方法
：此方法在数据库文件首次被创建时执行，且仅执行一次，你应该在这里编写创建数据表、视图等初始化结构的SQL语句，上面的代码就创建了一个名为 users的表。：当你需要修改数据库结构（如添加新列、创建新表）时，需要增加 DATABASE_VERSION的值，系统检测到版本号变化后，会调用此方法，你可以在这里执行数据迁移逻辑。
打开并操作数据库
创建了DatabaseHelper后，打开数据库就变得非常简单，你只需要实例化这个Helper，然后调用它的getWritableDatabase()或getReadableDatabase()方法即可。
这两个方法都返回一个SQLiteDatabase对象，通过这个对象你就可以执行SQL命令（如insert, query, update, delete）来操作数据。
方法选择对比
| 方法 | 返回值 | 使用场景 |
|---|---|---|
getWritableDatabase() | 可读写的SQLiteDatabase对象 | 当你需要向数据库写入、更新或删除数据时使用，如果磁盘已满或数据库被锁定，可能会抛出异常。 |
getReadableDatabase() | 可读的SQLiteDatabase对象 | 当你只需要查询数据时使用，如果数据库不可写（如磁盘满），它会返回一个只读的数据库实例，而不会抛出异常，因此更安全。 |
示例：打开数据库并插入数据
// 在Activity或Fragment中
val dbHelper = DatabaseHelper(this)
// 获取可写的数据库对象
val db = dbHelper.writableDatabase
// 准备数据
val values = ContentValues().apply {
put(DatabaseHelper.COLUMN_NAME, "张三")
}
// 插入数据
val newRowId = db.insert(DatabaseHelper.TABLE_NAME, null, values)
// 使用完毕后关闭数据库连接
db.close() 如何直观地查看和打开数据库文件
在开发阶段,我们经常需要查看数据库中的数据以进行调试，Android Studio提供了强大的“Database Inspector”工具，让你无需将数据库导出即可直接查看。
使用步骤如下：
- 在安卓设备或模拟器上运行你的应用,并确保已经执行了创建数据库和插入数据的操作。
- 打开Android Studio，在底部菜单栏中找到并点击
View->Tool Windows->Database Inspector。 - 在Database Inspector窗口中，从顶部的下拉菜单选择你的应用进程。
- 窗口会自动列出你的应用创建的所有数据库文件（如
MyDatabase.db），点击数据库旁边的展开箭头，可以看到其中的所有表。 - 双击表名,即可在右侧窗口中实时查看表中的数据，你还可以直接在此窗口中执行自定义的SQL查询。
这个工具极大地提升了调试数据库相关功能的效率。
相关问答FAQs
数据库文件实际存储在设备的哪个位置？
解答： 默认情况下，通过SQLiteOpenHelper创建的数据库文件存储在应用的私有目录中，具体路径为：/data/data/<你的应用包名>/databases/<你的数据库名称.db>，这个目录是应用私有的，其他应用无法访问，用户在没有root权限的情况下也无法直接看到，当应用被卸载时，该目录下的所有文件（包括数据库）都会被系统自动删除。
onCreate和onUpgrade方法在什么时候被调用？
解答： 这两个方法的调用时机是严格由数据库版本控制的。
：当你的应用代码中第一次调用 getReadableDatabase()或getWritableDatabase()，并且此时设备上不存在指定名称的数据库文件时，系统会创建数据库文件，并调用onCreate()方法，它只会在数据库的整个生命周期中调用一次。：当数据库文件已经存在，但你传递给 SQLiteOpenHelper构造函数的版本号（DATABASE_VERSION）比设备上现有数据库文件的版本号要高时，系统会调用onUpgrade()方法，这为你提供了一个执行数据库结构升级（如添加字段、修改表结构）的入口。
【版权声明】：本站所有内容均来自网络，若无意侵犯到您的权利，请及时与我们联系将尽快删除相关内容!
发表回复