android room 数据库保存位置

原创

mob64ca12cfa7d5 2025-01-31 07:15:47 ©著作权

文章标签 android 数据库 User 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob64ca12cfa7d5的原创作品，请联系作者获取转载授权，否则将追究法律责任

Android Room 数据库保存位置的实现指南

在现代 Android 开发中，Room 数据库是一个流行的持久性库，它简化了数据存取的过程，帮助开发者以 SQLite 数据库的形式保存应用数据。在这篇文章中，我们将一步步讲解如何在安卓应用中实现 Room 数据库的保存位置。

一、整体流程

以下是实现 Room 数据库保存位置的基本步骤：

步骤	描述
1	添加 Room 依赖项
2	创建数据库实体类
3	创建 DAO 接口
4	创建数据库类
5	在应用中使用 Room 数据库

二、每一步的详细实现

1. 添加 Room 依赖项

首先，我们需要在项目的 build.gradle 文件中添加 Room 的依赖项。打开 app/build.gradle 文件并添加以下代码：

dependencies {
    def room_version = "2.5.0"
    
    implementation "androidx.room:room-runtime:$room_version" // Room 核心库
    annotationProcessor "androidx.room:room-compiler:$room_version" // Room 注解处理器
    // 如果使用 Kotlin
    kapt "androidx.room:room-compiler:$room_version" // Kotlin 项目使用 kapt
}

2. 创建数据库实体类

接下来，我们需要创建一个实体类，用于定义我们要存储的数据。假设我们要创建一个简单的用户表，我们可以创建一个名为 User 的实体类。

import androidx.room.Entity;
import androidx.room.PrimaryKey;

@Entity(tableName = "user_table")
public class User {
    
    @PrimaryKey(autoGenerate = true)  // 主键自增
    private int id;

    private String name;
    private int age;

    // 构造方法
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // 获取和设置方法
    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

3. 创建 DAO 接口

DAO（数据访问对象）接口定义了如何与数据库交互。创建一个名为 UserDao 的接口，通过 SQL 查询来实现用户数据的增、删、查、改。

import androidx.room.Dao;
import androidx.room.Insert;
import androidx.room.Delete;
import androidx.room.Query;

import java.util.List;

@Dao
public interface UserDao {

    @Insert // 插入操作
    void insert(User user);

    @Delete // 删除操作
    void delete(User user);

    @Query("SELECT * FROM user_table ORDER BY id ASC") // 查询按 id 升序排列
    List<User> getAllUsers();
}

4. 创建数据库类

现在，我们需要一个数据库类来连接上述实体和 DAO。我们将创建一个名为 UserDatabase 的抽象类。

import androidx.room.Database;
import androidx.room.Room;
import androidx.room.RoomDatabase;
import android.content.Context;

@Database(entities = {User.class}, version = 1, exportSchema = false) // 数据库类，定义实体和版本
public abstract class UserDatabase extends RoomDatabase {

    public abstract UserDao userDao(); // 得到 DAO 的方法

    private static UserDatabase INSTANCE;

    // 获取数据库实例
    public static synchronized UserDatabase getInstance(Context context) {
        if (INSTANCE == null) {
            INSTANCE = Room.databaseBuilder(context.getApplicationContext(),
                    UserDatabase.class, "user_database")
                    .fallbackToDestructiveMigration() // 迁移备份
                    .build();
        }
        return INSTANCE;
    }
}

5. 在应用中使用 Room 数据库

最后，我们需要在应用中实际使用 Room 数据库。我们将在一个 Activity 或 ViewModel 中插入和查询用户数据。

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;

import java.util.List;

public class MainActivity extends AppCompatActivity {

    private UserDao userDao;
    private UserDatabase userDatabase;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        userDatabase = UserDatabase.getInstance(this); // 实例化 UserDatabase
        userDao = userDatabase.userDao(); // 实例化 UserDao

        // 插入一名用户
        User user = new User("Alice", 25);
        new Thread(() -> userDao.insert(user)).start(); // 在子线程中插入用户

        // 查询所有用户
        new Thread(() -> {
            List<User> users = userDao.getAllUsers(); // 获取所有用户
            for (User u : users) {

                // 日志输出每个用户的信息
                Log.d("MainActivity", "User ID: " + u.getId() + ", Name: " + u.getName() + ", Age: " + u.getAge());
            }
        }).start();
    }
}