學習Android Room資料庫操作指南

在 Android 應用程序中，數據存儲是無法避免的。你需要在你的應用程序中存儲和管理用戶數據。Android 為開發者提供了不同類型的存儲選項，包括 Shared Preferences、文件存儲、SQLite 資料庫等。其中，SQLite 是一個輕量級關係型資料庫，常用於 Android 應用程序的本地數據存儲。繼承自 Android 資料庫框架，Room 是一種持久性庫，用於在 SQLite 資料庫之上構建資料庫訪問的抽象層。它是 Google 推薦的用於數據存儲的解決方案。

一、Room架構及其組件

Room 是 Google 推薦的解決方案，用於在 SQLite 資料庫之上構建資料庫訪問的抽象層。Room 的架構具有以下三個主要組件：

• Database：Room 資料庫的持有者。包括資料庫持久性、提供對 DAO 的訪問，並通過getters獲取資料庫的實例，這些方法可以輕鬆地連接到數據源和運行查詢來讀取數據。
• Entity：Room 資料庫中的表。它代表了您要在表中訪問的實體對象。
• DAO：包含用於訪問資料庫的方法。DAO 提供了一種方法，您可以定義需要提取數據的查詢和更新操作。Room 在編譯時檢查這些查詢，並驗證它們是否存在資料庫中。

二、使用Room資料庫進行增刪改查操作

1、創建實體

首先我們需要創建 Entity。Entity 在資料庫中代表您要存儲的數據表。我們可以使用@Entity 注釋來完成此操作。在註解中，您可以指定表的名稱以及每個欄位的名稱。一個非常簡單的例子如下所示：

@Entity(tableName = "students")
public class Student {
    @PrimaryKey(autoGenerate = true)
    public int id;

    public String name;
    public int age;
    public String sex;
}

在上面的例子中，我們創建了一個名為 “students” 的表，然後定義了 id、name、age 和 sex 這幾個欄位。id 用 @PrimaryKey 注釋標記為主鍵，並設置為 autoGenerate = true，這意味著每當我們插入新數據時，Room 將自動為其分配遞增 ID。

2、創建 DAO

接下來我們需要創建 DAO，DAO 是一組方法，用於向 Room 資料庫執行查詢和更新操作。我們可以使用@Dao 注釋完成此操作。在 DAO 中，我們需要為資料庫中定義的每個實體編寫至少一個方法。以下是一個包含查詢和更新操作的例子：

@Dao
public interface StudentDao {
    @Query("SELECT * FROM students")
    List getAllStudents();

    @Insert
    void insertStudent(Student student);

    @Update
    void updateStudent(Student student);

    @Delete
    void deleteStudent(Student student);
}

在上面的例子中，我們定義了一些基本的操作：獲取所有學生列表，插入新的學生記錄，更新學生記錄和刪除學生記錄。它們分別使用 @Query、@Insert、@Update 和 @Delete 進行注釋。@Query 注釋用於執行自定義查詢，@Insert、@Update 和 @Delete 注釋用於執行相應的操作。

3、創建資料庫

現在，我們已經定義了實體和 DAO，接下來我們需要將它們與 Room 資料庫關聯。我們需要創建一個繼承 RoomDatabase 的抽象類，並定義我們的 DAO 和表。以下是一個簡單的例子：

@Database(entities = {Student.class}, version = 1)
public abstract class StudentDatabase extends RoomDatabase {
    public abstract StudentDao studentDao();
}

在這個例子中，我們定義了一組實體（Student），並將其與版本號 1 關聯。然後我們定義一個抽象方法 studentDao()，該方法返回對 DAO 的引用。這將是我們從應用程序代碼中訪問 DAO 的方式。

4、初始化資料庫

現在我們已經定義了實體、DAO 和資料庫類。接下來我們需要初始化資料庫。在應用程序中，我們應該只有一個資料庫實例。因此，我們需要使用 singleton 模式來確保只有一個實例。以下是一個簡單的例子：

public class DatabaseInitializer {
    private static StudentDatabase studentDatabase;

    public static void initStudentDatabase(Context context) {
        if (studentDatabase == null) {
            studentDatabase = Room.databaseBuilder(context, StudentDatabase.class, "student_database")
                    .build();
        }
    }

    public static StudentDao getStudentDao() {
        return studentDatabase.studentDao();
    }
}

在這個例子中，我們創建了一個單例資料庫初始化器類。initStudentDatabase() 方法負責初始化 Room 資料庫。這個方法在我們的應用程序第一次啟動時被調用，並且只能被調用一次。getStudentDao() 方法返回一個 DAO 對象的實例，以便我們可以在應用程序中直接使用。

5、進行增刪改查操作

我們已經定義了實體、DAO、資料庫，並進行了資料庫初始化。現在，我們可以使用 DAO 中定義的方法進行增刪改查操作。以下是一些樣例代碼：

DatabaseInitializer.initStudentDatabase(getApplicationContext());

// 插入一條學生記錄
Student student1 = new Student();
student1.name = "Alex";
student1.age = 20;
student1.sex = "Male";
DatabaseInitializer.getStudentDao().insertStudent(student1);

// 獲取所有的學生記錄
List students = DatabaseInitializer.getStudentDao().getAllStudents();

// 更新一條學生記錄
Student student2 = students.get(0);
student2.name = "Alice";
DatabaseInitializer.getStudentDao().updateStudent(student2);

// 刪除一條學生記錄
Student student3 = students.get(1);
DatabaseInitializer.getStudentDao().deleteStudent(student3);

三、總結

以上是關於如何使用 Room 進行 Android 資料庫操作的簡要指南。Room 是一個非常方便和易於使用的庫，它可以幫助我們輕鬆地進行數據存儲操作。不僅如此，Room 還提供了強大的查詢語言，可以大大簡化複雜的資料庫操作和查詢。在進行實際開發的時候，我們可以根據具體業務需求，參照以上代碼示例進行相應的調整和擴展。