Android : Room 數據庫的基本用法

1.Room介紹：

Android Room 是 Android 官方提供的一個持久性庫，用于在 Android 應用程序中管理數據庫。它提供了一個簡單的 API 層，使得使用 SQLite 數據庫變得更加容易和方便。

以下是 Android Room 的主要特點：

對象關系映射 (ORM)：Room 允許您將 Java 或 Kotlin 對象映射到數據庫表中。您可以定義數據模型并使用注解來定義關系和約束。
事務管理：Room 提供了事務管理的功能，可以確保數據的完整性和一致性。它還支持自動提交和回滾機制，類似于 JDBC 中的事務管理。
數據庫抽象：Room 提供了一個抽象層，使得您可以使用簡單的 API 來執行 SQL 查詢和操作數據庫。您不需要編寫手動的 SQL 語句，而是使用 Java 或 Kotlin 的查詢 API。
同步和異步操作：Room 支持同步和異步操作，使得您可以輕松地在后臺線程中執行數據庫操作，以避免阻塞主線程。
數據庫遷移：當您的應用程序更新時，可能需要更改數據庫模式。Room 可以自動處理遷移過程，確保數據的一致性和完整性。
并發支持：Room 支持多線程并發操作，可以有效地處理多個并發請求。
嵌入式數據庫：Room 支持嵌入式數據庫，這意味著您可以將數據庫文件嵌入到您的應用程序中，而不需要單獨安裝和管理 SQLite 數據庫。
支持跨平臺：除了 Android 平臺，Room 還支持 iOS 和桌面應用程序。

總之，Android Room 是一個功能強大的持久性庫，使得管理 SQLite 數據庫變得更加簡單和方便。它提供了一個對象關系映射層、事務管理、數據庫抽象等功能，可以幫助您更輕松地構建和管理 Android 應用程序中的數據庫。

2.Room使用：

使用教程：?Room ?|? Jetpack ?|? Android Developers

開發文檔：androidx.room ?|? Android Developers

1.導入依賴：在build.gradle文件中加入

dependencies {//Roomdef room_version = "2.5.0"implementation "androidx.room:room-runtime:$room_version"annotationProcessor "androidx.room:room-compiler:$room_version"
}

2.創建實體類 People.java

package com.example.myroom.entity;import androidx.room.ColumnInfo;
import androidx.room.Entity;
import androidx.room.PrimaryKey;//實體類 表名 不寫默認內名首字母小寫 people
@Entity(tableName = "people")
public class People {//主鍵 自動生成@PrimaryKey(autoGenerate = true)private int id;//列的名稱@ColumnInfo(name = "user_name")private String name;//不寫默認列的名稱為age，sexprivate int age;private String sex;public People(String name, int age, String sex) {this.name = name;this.age = age;this.sex = sex;}public void setId(int id) {this.id = id;}public int getId() {return 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;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}
}

3.創建一個接口Dao? PeopleDao.java

package com.example.myroom.dao;import androidx.room.Dao;
import androidx.room.Delete;
import androidx.room.Insert;
import androidx.room.Query;
import androidx.room.Update;import com.example.myroom.entity.People;import java.util.List;//dao database access object 接口 處理數據庫的方法簽名
@Dao
public interface PeopleDao {//添加  傳遞一個參數 對象@Insertvoid insertDataOne(People people);//添加  可以傳遞多個參數 對象@Insertvoid insertDataS(People... people);//刪除@Deleteint deleteDataS(People... people);//修改 傳入對象 設置 id 進行修改某一個@Updateint updateData(People... people);//查詢 根據id倒序@Query("select * from people order by id desc")List<People> getPeoples();//根據id查詢@Query("select * from people where id =:numb")People getPeople(Integer numb);//刪除表數據@Query("delete from people")void deleteTableData();}

4.寫個抽象類繼承RoodDatabase

package com.example.myroom.dao;import androidx.room.Database;
import androidx.room.RoomDatabase;import com.example.myroom.entity.People;//抽象類 繼承 RoomDatabase      我們不用實現people中的方法
// version = 1 數據庫版本，exportSchema = false不允許導出數據庫的架構
@Database(entities = {People.class}, version = 1, exportSchema = false)
public abstract class PeopleDataBase extends RoomDatabase {/*** Java 抽象類的一些特點* 不能被實例化：抽象類不能被實例化，因為它沒有具體的實現細節。它只能被繼承，并且子類必須實現抽象類中的所有抽象方法。* 包含抽象方法：抽象類可以包含抽象方法，這些方法只有聲明但沒有實現。子類必須實現這些抽象方法，否則它也必須被聲明為抽象類。* 提供通用功能和行為：抽象類提供了一些通用功能和行為，這些功能和行為可以被其子類繼承和重用。子類可以根據需要擴展這些功能和行為，或者重寫它們以提供不同的實現。* 用于設計高層次的抽象：抽象類可以用于表示一個高層次的抽象概念或者一個通用模板，使得代碼更加模塊化和可維護。通過將一些公共方法和行為提取到一個抽象類中，可以避免在多個子類中重復實現相同的功能。* 擴展性：抽象類可以定義一些擴展的接口，子類可以選擇實現這些接口來提供額外的功能。這使得抽象類具有很好的擴展性，可以根據需要添加新的功能和行為*//*public abstract PeopleDao peopleDao();}

4.MainActivity.java

package com.example.myroom;import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;import androidx.appcompat.app.AppCompatActivity;
import androidx.room.Room;import com.example.myroom.dao.PeopleDao;
import com.example.myroom.dao.PeopleDataBase;
import com.example.myroom.entity.People;import java.util.List;public class MainActivity extends AppCompatActivity {PeopleDataBase DB;private Button btnInsert, btnDelete, btnUpdate, btnSelect, btnDeleteData;private TextView textContent;private EditText etName, etAge, etSex, etSelect, etDelete, etUpdate;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);DB = Room.databaseBuilder(this, PeopleDataBase.class, "peopleDB")// 默認不允許在主線程中連接數據庫   強制在主線程中處理.allowMainThreadQueries().build();textContent = findViewById(R.id.tvcontent);etName = findViewById(R.id.etName);etAge = findViewById(R.id.etAge);etSex = findViewById(R.id.etSex);etSelect = findViewById(R.id.etSelect);etDelete = findViewById(R.id.etDelete);etUpdate = findViewById(R.id.etUpdate);btnInsert = findViewById(R.id.btnSave);btnDelete = findViewById(R.id.btnDelete);btnUpdate = findViewById(R.id.btnUpdate);btnSelect = findViewById(R.id.btnselect);btnDeleteData = findViewById(R.id.btnDeleteTB);//查詢數據selectData(null);//按鈕事件 插入數據btnInsert.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {//插入數據 防止空String name = etName.getText().toString().equals("") ? "張三" : etName.getText().toString();int age = etAge.getText().toString().equals("") ? 20 : Integer.parseInt(etAge.getText().toString());String sex = etSex.getText().toString().equals("") ? "男" : etSex.getText().toString();People people = new People(name, age, sex);DB.peopleDao().insertDataS(people);//查詢數據selectData(null);}});//修改數據btnUpdate.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {//修改int id = etUpdate.getText().toString().equals("") ? 0 : Integer.parseInt(etUpdate.getText().toString());if (id != 0) {String name = etName.getText().toString();int age = Integer.parseInt(etAge.getText().toString());String sex = etSex.getText().toString();People people = new People(name, age, sex);people.setId(id);DB.peopleDao().updateData(people);//查詢selectData(null);}}});//刪除btnDelete.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {int id = etDelete.getText().toString().equals("") ? 0 : Integer.parseInt(etDelete.getText().toString());if (id != 0) {People people = new People();people.setId(id);DB.peopleDao().deleteDataS(people);//查詢selectData(null);}}});//根據id 查數據btnSelect.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {int id = etSelect.getText().toString().equals("") ? 0 : Integer.parseInt(etSelect.getText().toString());if (id != 0) {selectData(id);}}});//刪除全部數據btnDeleteData.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {DB.peopleDao().deleteTableData();}});}/*** 查詢數據的方法*/public void selectData(Integer id) {try {StringBuilder text = new StringBuilder();if (id == null || id == 0) {List<People> peopleList = DB.peopleDao().getPeoples();if (peopleList.size() != 0) {for (int i = 0; i < peopleList.size(); i++) {People people = peopleList.get(i);text.append("id:").append(people.getId()).append("---name:").append(people.getName()).append("---age:").append(people.getAge()).append("---sex:").append(people.getSex()).append("\n");}} else {text.append("沒有可用的數據");}} else {People people = DB.peopleDao().getPeople(id);text.append("id:").append(people.getId()).append("---name:").append(people.getName()).append("---age:").append(people.getAge()).append("---sex:").append(people.getSex());}textContent.setText(text.toString());} catch (Exception e) {Log.e("TAG", "----查詢失敗------------" + e.getMessage());}}}

5.布局文件 activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><Buttonandroid:id="@+id/btnUpdate"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="修改"app:layout_constraintBottom_toBottomOf="@+id/etUpdate"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toEndOf="@+id/etUpdate"app:layout_constraintTop_toTopOf="@+id/etUpdate"app:layout_constraintVertical_bias="0.0" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline2"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="horizontal"app:layout_constraintGuide_percent="0.05" /><TextViewandroid:id="@+id/textView"android:layout_width="match_parent"android:layout_height="0dp"android:text="Room簡單應用："android:textSize="24sp"app:layout_constraintBottom_toTopOf="@+id/guideline2"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent" /><Buttonandroid:id="@+id/btnSave"android:layout_width="wrap_content"android:layout_height="wrap_content"android:layout_marginTop="4dp"android:text="保存"app:layout_constraintBottom_toTopOf="@+id/guideline9"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.203"app:layout_constraintStart_toStartOf="@+id/guideline5"app:layout_constraintTop_toTopOf="@+id/guideline4" /><Buttonandroid:id="@+id/btnDelete"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="刪除"app:layout_constraintBottom_toBottomOf="@+id/etDelete"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toEndOf="@+id/etDelete"app:layout_constraintTop_toTopOf="@+id/etDelete" /><Buttonandroid:id="@+id/btnselect"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="查詢"app:layout_constraintBottom_toBottomOf="@+id/etSelect"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toEndOf="@+id/etSelect"app:layout_constraintTop_toTopOf="@+id/etSelect" /><Buttonandroid:id="@+id/btnDeleteTB"android:layout_width="wrap_content"android:layout_height="wrap_content"android:layout_marginTop="4dp"android:text="刪除表數據"app:layout_constraintBottom_toTopOf="@+id/guideline9"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.873"app:layout_constraintStart_toStartOf="@+id/guideline5"app:layout_constraintTop_toTopOf="@+id/guideline4" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline3"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="horizontal"app:layout_constraintGuide_percent="0.13" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline4"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="horizontal"app:layout_constraintGuide_percent="0.29548565" /><TextViewandroid:id="@+id/textView2"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="姓名："android:textSize="24sp"app:layout_constraintBottom_toTopOf="@+id/guideline3"app:layout_constraintEnd_toStartOf="@+id/etName"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toStartOf="@+id/guideline5" /><EditTextandroid:id="@+id/etName"android:layout_width="200dp"android:layout_height="wrap_content"android:ems="10"android:hint="請輸入"android:inputType="text"app:layout_constraintBottom_toBottomOf="@+id/textView2"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toEndOf="@+id/textView2"app:layout_constraintTop_toTopOf="@+id/textView2" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline5"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="vertical"app:layout_constraintGuide_percent="0.05352798" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline6"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="horizontal"app:layout_constraintGuide_percent="0.21" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline8"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="horizontal"app:layout_constraintGuide_percent="0.6" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline9"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="horizontal"app:layout_constraintGuide_percent="0.37" /><TextViewandroid:id="@+id/textView3"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="性別："android:textSize="24sp"app:layout_constraintBottom_toTopOf="@+id/guideline6"app:layout_constraintEnd_toStartOf="@+id/etSex"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toStartOf="@+id/guideline5" /><EditTextandroid:id="@+id/etSex"android:layout_width="200dp"android:layout_height="wrap_content"android:ems="10"android:hint="請輸入"android:inputType="text"app:layout_constraintBottom_toBottomOf="@+id/textView3"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toEndOf="@+id/textView3"app:layout_constraintTop_toTopOf="@+id/textView3" /><EditTextandroid:id="@+id/etAge"android:layout_width="200dp"android:layout_height="wrap_content"android:ems="10"android:hint="請輸入"android:inputType="text"app:layout_constraintBottom_toBottomOf="@+id/textView4"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toEndOf="@+id/textView4"app:layout_constraintTop_toTopOf="@+id/textView4" /><TextViewandroid:id="@+id/textView4"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="年齡："android:textSize="24sp"app:layout_constraintBottom_toTopOf="@+id/guideline4"app:layout_constraintEnd_toStartOf="@+id/etAge"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toStartOf="@+id/guideline5" /><androidx.constraintlayout.widget.Guidelineandroid:id="@+id/guideline10"android:layout_width="wrap_content"android:layout_height="wrap_content"android:orientation="vertical"app:layout_constraintGuide_percent="0.9" /><EditTextandroid:id="@+id/etSelect"android:layout_width="100dp"android:layout_height="wrap_content"android:ems="10"android:hint="請輸入id"android:inputType="number"app:layout_constraintBottom_toTopOf="@+id/guideline8"app:layout_constraintEnd_toStartOf="@+id/btnselect"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toStartOf="@+id/guideline5"app:layout_constraintTop_toTopOf="@+id/guideline9"app:layout_constraintVertical_bias="0.0" /><EditTextandroid:id="@+id/etDelete"android:layout_width="100dp"android:layout_height="wrap_content"android:ems="10"android:hint="請輸入id"android:inputType="number"app:layout_constraintBottom_toTopOf="@+id/guideline8"app:layout_constraintEnd_toStartOf="@+id/btnDelete"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toStartOf="@+id/guideline5"app:layout_constraintTop_toTopOf="@+id/guideline9"app:layout_constraintVertical_bias="0.451" /><EditTextandroid:id="@+id/etUpdate"android:layout_width="100dp"android:layout_height="wrap_content"android:ems="10"android:hint="請輸入id"android:inputType="number"app:layout_constraintBottom_toTopOf="@+id/guideline8"app:layout_constraintEnd_toStartOf="@+id/btnUpdate"app:layout_constraintHorizontal_bias="0.5"app:layout_constraintStart_toStartOf="@+id/guideline5"app:layout_constraintTop_toTopOf="@+id/etSelect"app:layout_constraintVertical_bias="1.0" /><TextViewandroid:id="@+id/tvcontent"android:layout_width="0dp"android:layout_height="0dp"app:layout_constraintBottom_toBottomOf="parent"app:layout_constraintEnd_toStartOf="@+id/guideline10"app:layout_constraintStart_toStartOf="@+id/guideline5"app:layout_constraintTop_toTopOf="@+id/guideline8"tools:hint="這里顯示數據" /></androidx.constraintlayout.widget.ConstraintLayout>

示例圖：