在安卓应用开发中，数据持久化是至关重要的一环，无论是保存用户设置、缓存数据还是存储结构化的业务信息，一个可靠、轻量级的数据库都是必不可少的，SQLite正是为此而生，它是一个内嵌在安卓系统中的关系型数据库引擎，无需单独安装服务器，直接读写文件即可操作，安卓怎么创建SQLite数据库文件呢？本文将详细、系统地介绍这一过程，从核心概念到具体实践,助你掌握在安卓中创建和管理SQLite数据库的技巧。
核心基石：SQLiteOpenHelper 类
安卓系统不推荐开发者直接使用原生SQL API来创建和管理数据库，而是提供了一个强大的辅助类——android.database.sqlite.SQLiteOpenHelper，这个类是管理数据库创建和版本更新的最佳实践，它封装了所有底层操作,让我们能更专注于业务逻辑。
SQLiteOpenHelper 是一个抽象类，我们需要创建一个子类并实现它的核心方法,它的主要职责包括：
- 创建数据库：当数据库文件不存在时,自动创建。
- 打开数据库：获取可读或可写的数据库对象。
- 版本管理：当应用升级需要修改数据库结构时,提供更新机制。
为了更好地理解其工作流程,我们可以通过下表来了解它的关键方法：
| 方法名 | 调用时机 | 主要用途 |
|---|---|---|
onCreate(SQLiteDatabase db) | 数据库文件首次被创建时调用 | 执行创建表、初始化数据等操作 |
onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) | 数据库版本号升高时调用 | 执行修改表结构、添加新列、数据迁移等操作 |
onOpen(SQLiteDatabase db) | 数据库被成功打开时调用 | 可选实现，用于执行一些数据库打开后的额外操作 |
getWritableDatabase() | 需要对数据库进行增、删、改操作时调用 | 返回一个可写的SQLiteDatabase对象，如果磁盘满或权限不足会抛出异常 |
getReadableDatabase() | 只需读取数据库或写入可能失败时调用 | 返回一个可读的SQLiteDatabase对象，在无法写入时会返回只读连接，更安全 |
分步实践：创建你的第一个数据库
下面，我们将通过一个具体的例子，一步步创建一个名为 UserDB.db 的数据库，并在其中创建一张 users 表。
第一步：创建数据库帮助类
在你的项目中创建一个新的Java或Kotlin类，让它继承自 SQLiteOpenHelper，我们将其命名为 DatabaseHelper。
// DatabaseHelper.java
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
public class DatabaseHelper extends SQLiteOpenHelper {
// 数据库名称
private static final String DATABASE_NAME = "UserDB.db";
// 数据库版本，每次升级数据库时需要增加此值
private static final int DATABASE_VERSION = 1;
// 表名
public static final String TABLE_USERS = "users";
// 创建表的SQL语句
private static final String CREATE_TABLE_USERS = "CREATE TABLE " + TABLE_USERS + " (" +
"id INTEGER PRIMARY KEY AUTOINCREMENT, " +
"name TEXT NOT NULL, " +
"email TEXT UNIQUE, " +
"age INTEGER" +
")";
// 构造函数
public DatabaseHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
// 当数据库首次被创建时，onCreate方法会被调用
@Override
public void onCreate(SQLiteDatabase db) {
// 在这里执行创建表的操作
db.execSQL(CREATE_TABLE_USERS);
}
// 当数据库需要升级时，onUpgrade方法会被调用
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 简单粗暴的策略：删除旧表，然后重新创建
// 注意：这会导致旧数据丢失，生产环境中应谨慎处理数据迁移
db.execSQL("DROP TABLE IF EXISTS " + TABLE_USERS);
onCreate(db);
}
} 代码解析：
- 常量定义：我们将数据库名、版本号、表名和SQL语句定义为常量,便于维护和修改。
- 构造函数：我们调用了父类的构造函数，传入了
Context、数据库名、一个自定义的CursorFactory（通常为null）和数据库版本号。 ：这是创建数据库文件的核心，当 getWritableDatabase()或getReadableDatabase()被首次调用，且系统发现UserDB.db文件不存在时，就会触发此方法，我们在这里使用db.execSQL()执行了创建users表的SQL语句。：当你在应用更新后，修改了 DATABASE_VERSION的值（例如从1变为2），系统在打开数据库时会检测到版本变化，并调用此方法，这里的示例是简单的“删表重建”，实际项目中，你需要根据oldVersion和newVersion来执行更复杂的数据迁移逻辑，比如使用ALTER TABLE语句添加新列。
第二步：在Activity中使用数据库
创建好DatabaseHelper后，我们就可以在应用的任何组件（如Activity、Service）中使用它了。
// MainActivity.java (示例片段)
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
private DatabaseHelper dbHelper;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 1. 初始化DatabaseHelper
dbHelper = new DatabaseHelper(this);
// 2. 获取可写的数据库对象，这会触发数据库的创建或打开
// 如果数据库文件不存在，系统会调用DatabaseHelper的onCreate方法来创建它
SQLiteDatabase db = dbHelper.getWritableDatabase();
// 数据库文件 /data/data/<你的包名>/databases/UserDB.db 已经被创建
// users 表也已经建立完毕
Toast.makeText(this, "数据库创建成功！", Toast.LENGTH_SHORT).show();
// 3. (可选) 使用完毕后关闭数据库连接
// 注意：在实际应用中，数据库连接的生命周期管理很重要，不要在onCreate中就关闭它
// 这里仅为演示
// db.close();
}
} 当你第一次运行这段代码并触发getWritableDatabase()时,安卓系统会执行以下操作：
- 检查应用私有目录下的
databases文件夹里是否存在UserDB.db文件。 - 如果不存在,则创建该文件。
- 调用
DatabaseHelper的onCreate()方法，在其中执行CREATE TABLE语句。 - 返回一个可写的
SQLiteDatabase对象供你使用。
至此,一个完整的SQLite数据库文件及其中的表结构就创建成功了。
数据库文件的位置
你可能会好奇，这个.db文件到底存储在哪里？对于每一个应用，安卓系统都为其分配了一个私有的存储空间，其他应用无法访问，你的SQLite数据库文件就存放在这个私有空间下的databases目录中。
具体路径是：/data/data/<你的应用包名>/databases/
如果你的应用包名是com.example.myapp，那么数据库路径就是/data/data/com.example.myapp/databases/UserDB.db，你可以通过Android Studio的 Device File Explorer 工具来查看和导出这个文件,以便进行调试和分析。
小编总结与进阶
创建SQLite数据库文件的核心在于正确地使用SQLiteOpenHelper，通过继承它并实现onCreate()和onUpgrade()方法，你可以将数据库的创建和版本管理逻辑优雅地封装起来。getWritableDatabase()或getReadableDatabase()是这一切的触发器。
在实际开发中，直接使用SQLiteDatabase的execSQL()、rawQuery()等方法虽然灵活，但容易出错且代码繁琐，谷歌官方推出了更现代化的数据库解决方案——Room持久化库，它在SQLite之上提供了一层抽象，通过注解让你能用更少的样板代码、更强的类型安全（编译时检查SQL错误）和更流畅的API（如返回LiveData或Flow）来操作数据库，对于新项目,强烈推荐优先考虑使用Room。
相关问答FAQs
问题1：创建数据库后，我能直接在手机的文件管理器中看到 .db 文件吗？
回答：不能，出于安全和隐私考虑，安卓系统为每个应用都分配了独立的内部存储空间，这个空间是私有的，默认情况下，用户和其他应用都无法访问，你无法通过手机自带的文件管理器找到/data/data/目录下的任何内容，要查看数据库文件，你需要借助开发工具，最常用的就是Android Studio内置的 Device File Explorer，连接你的设备或启动模拟器后，在Android Studio底部的工具栏中找到它，然后导航到/data/data/<你的包名>/databases/路径,就可以看到你的数据库文件了。
问题2：onCreate 和 onUpgrade 方法具体什么时候会被调用？调用频率是怎样的？
回答：这两个方法的调用时机非常明确,且与数据库版本号紧密相关：
：它只会在数据库文件不存在时被调用，且仅调用一次，当你第一次调用 getWritableDatabase()或getReadableDatabase()时，如果系统在指定路径下找不到数据库文件，就会创建一个新文件，并立即调用onCreate()方法来初始化数据库结构（如创建表），之后只要数据库文件存在,这个方法就再也不会被调用了。：它只会在数据库文件已存在，但你传入的 SQLiteOpenHelper构造函数中的版本号（DATABASE_VERSION）高于当前数据库文件的版本号时被调用，你的应用V1.0版本号是1，用户安装后数据库创建成功，当你的应用升级到V2.0，你将代码中的DATABASE_VERSION改为2并发布，用户更新应用后，再次打开应用，系统会发现旧数据库文件版本是1，而新代码要求的版本是2，于是就会调用onUpgrade()方法，让你有机会更新数据库结构,这个方法会在每次版本号提升时被调用。
【版权声明】：本站所有内容均来自网络，若无意侵犯到您的权利，请及时与我们联系将尽快删除相关内容!
发表回复