Room là thư viện CSDL chính thức của Android, xây trên SQLite với kiểm tra câu lệnh khi biên dịch. Bài này tạo Entity, DAO, Database và kết nối với ViewModel.

55 phútNâng cao
Bạn sẽ học được
  • Entity, DAO, Database
  • Truy vấn trả về Flow
  • Thêm, sửa, xóa với coroutine
  • Repository

Cơ sở lý thuyết

Room là thư viện ORM (ánh xạ đối tượng – quan hệ) trên SQLite, CSDL nhúng có sẵn trong mọi máy Android. Room kiểm tra câu lệnh SQL ngay khi biên dịch (sai tên cột là báo lỗi), tự sinh mã ánh xạ và trả dữ liệu dưới dạng Flow để giao diện tự cập nhật khi bảng thay đổi.

  • Entity ánh xạ thành bảng; DAO (Data Access Object) khai báo truy vấn; Database là điểm truy cập, thường là singleton.
  • Thao tác CSDL không được chạy trên luồng chính (main thread) vì sẽ làm giao diện đơ; Room bắt buộc dùng suspend/Flow để chạy nền.
  • Migration: khi đổi cấu trúc bảng ở phiên bản mới, phải khai báo cách chuyển dữ liệu cũ để không mất dữ liệu người dùng.
  • Quan hệ giữa bảng dùng khóa ngoại và @Relation.

Room

@Entity(tableName = "sinhvien")
data class SinhVienEntity(@PrimaryKey val ma: String, val ten: String, val diem: Double)

@Dao
interface SinhVienDao {
    @Query("SELECT * FROM sinhvien ORDER BY diem DESC")
    fun tatCa(): Flow<List<SinhVienEntity>>
    @Upsert suspend fun luu(sv: SinhVienEntity)
    @Delete suspend fun xoa(sv: SinhVienEntity)
}

@Database(entities = [SinhVienEntity::class], version = 1)
abstract class AppDb : RoomDatabase() { abstract fun svDao(): SinhVienDao }

// ViewModel
val ds = dao.tatCa().stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList())
fun luu(sv: SinhVienEntity) = viewModelScope.launch { dao.luu(sv) }

Ứng dụng thực tế

Bài toán: ứng dụng sổ tay chi tiêu cá nhân lưu hoàn toàn trên máy (không cần mạng), thống kê tổng chi theo tháng bằng truy vấn SQL:

@Entity data class KhoanChi(@PrimaryKey(autoGenerate = true) val id: Int = 0,
                            val noiDung: String, val soTien: Long, val ngay: Long)

data class TongThang(val thang: String, val tong: Long)

@Dao interface ChiTieuDao {
    @Insert suspend fun them(k: KhoanChi)
    @Query("""SELECT strftime('%Y-%m', ngay / 1000, 'unixepoch') AS thang, SUM(soTien) AS tong
              FROM KhoanChi GROUP BY thang ORDER BY thang DESC""")
    fun tongTheoThang(): Flow<List<TongThang>>
}
Mẹo hay

Xem dữ liệu trong CSDL bằng App Inspection > Database Inspector của Android Studio.

Thực hành
  1. Lưu danh sách sinh viên bằng Room.
  2. Thêm chức năng sửa điểm.
  3. Tìm kiếm theo tên bằng truy vấn LIKE.
Tóm tắt bài học
  • Entity = bảng, DAO = truy vấn, Database = CSDL.
  • Flow tự cập nhật giao diện khi dữ liệu đổi.
  • Thao tác ghi chạy trong coroutine.