Firebase – Android: Cloud Firestore

Thứ Hai, 21/09/2020

Tram Ho

1. Compare Cloud Firestore and Realtime Database

Chắc hẳn ai cũng biết có một loại database quen thuộc là Relational Database, vậy nó có gì khác so với Firestore ? Dưới đây là bảng chỉ ra sự khác biệt :

Concept	Firestore	Relational database
Programing language	NoSQL	SQL
Category of object	Collection group	Table
One object	Document	Row
Individual data for an object	Field	Column
Unique ID for an object	Document ID	Primary key

Trong Firebase nó lại có 2 loại đó là Cloud Firestore và Realtime Database, nhưng vì sao Cloud Firestore lại được nhắc tới nhiều hơn, mình cùng tìm hiểu nhé !

Firebase đưa ra 2 cloud-based :

Cloud Firestore là một database mới nhất của Firebase cho bên mobile. Nó được xây dựng dựa trên Realtime Database với mô hình dữ liệu mới và trực quan hơn. Cloud Firestore cũng đưa ra nhiều tình năng hơn, querry nhanh hơn và quy mô rộng hơn so với Realtime Database.
Realtime Database là database chính gốc của Firebase. Đó là một giải pháp hiệu quả, có độ trễ thấp dành cho app mibile mà yêu cầu trạng thái được đồng bộ hóa giữa các máy khách trong thời gian thực.

Vậy database nào được Firebase khuyến khích sử dụng? Sự lựa chọn sử dụng database nào còn phụ thuộc vào nhiều yếu tố, tùy vào từng tính năng cụ thể mà người dùng có thể chọn loại database nào phù hợp.

Cả hai database đều có chung những điểm sau :

Client-first SDKs, không cần có server để deploy và maintain.
Realtime updates

Ngoài ra còn có một số điểm khác biệt nổi bật như sau :

	Cloud Firestore	Realtime Database
Data model	+ Lưu trữ dữ liệu dưới dạng collections và documents. + Dữ liệu đơn giản được lưu trữ trong document, nó khá giống với JSON. + Với những dữ liệu phức tạp, phân cấp thì cũng dễ tổ chức hơn bằng cách sử dụng các subcollections kết nối với các documents. + Ít có những yêu cầu về việc phải chuẩn hóa và làm gọn dữ liệu	+ Lưu trữ dữ liệu dưới dạng một cây JSON lớn. + Những data đơn giản cũng rất dễ dàng lưu trữ. + Với những data phức tạp và phân cấp thì khó quản lý hơn
Querying	+ Truy vấn với việc đánh chỉ mục và có thể sử dụng cả sort và filter cùng lúc	+ Truy vấn sâu bị giới hạn, chỉ được sử dụng sort hoặc filter
Writes and transactions	+ Có những phương thức viết và chuyển đổi nâng cao.	+ Các phương thức này ở mức cơ bản

Xem thêm chi tiết tại đây !

Cấu trúc lưu trữ data của Firestore như sau :

Documents : là cấu trúc thấp nhất, nó lưu trữ được từ string cho đến binary:

Collections : chứa một hoặc nhiều các documents, có một số rule cho Collections như sau :

Collection chỉ chứa document, không có Collection string hay Collection binary.
Document không thể chứa document, nhưng nó có thể trỏ tới một subCollection.
Root của database của bạn chỉ có thể chứa Collections.
Ví dụ về một cấu trúc database của bạn như sau :

2. Create and setup a Cloud Firestore

Cài đặt project

Cài đặt firebase vào project, tham khảo tại đây !
Trong file build.gradle của project, thêm Google’s Maven repository trong cả hai khối buildscript và allprojects .
Thêm thư viện Cloud Firestore vào file app/build.gradle :

implementation <span class="token string">'com.google.firebase:firebase-firestore-ktx:21.6.0'</span>

1 2	implementation <span class="token string">'com.google.firebase:firebase-firestore-ktx:21.6.0'</span>

Build app example

Mình thiết kế một view gồm 2 editText và một button, khi click vào button thì sẽ lưu data ở hai editText này lên Firestore :

Code như sau :

<span class="token keyword">private</span> val documentRef <span class="token operator">=</span> <span class="token class-name">FirebaseFirestore</span><span class="token punctuation">.</span><span class="token function">getInstance</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">document</span><span class="token punctuation">(</span><span class="token string">"sampleData/home"</span><span class="token punctuation">)</span>

    <span class="token keyword">private</span> fun <span class="token function">setEvent</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
        btnSend<span class="token punctuation">.</span>setOnClickListener <span class="token punctuation">{</span>
            val dataToSave <span class="token operator">=</span> <span class="token class-name">HashMap</span><span class="token generics"><span class="token punctuation">&lt;</span><span class="token class-name">String</span><span class="token punctuation">,</span> <span class="token class-name">Any</span><span class="token punctuation">&gt;</span></span><span class="token punctuation">(</span><span class="token punctuation">)</span>
            dataToSave<span class="token punctuation">[</span><span class="token string">"KEY_NAME"</span><span class="token punctuation">]</span> <span class="token operator">=</span> editTextName<span class="token punctuation">.</span>text<span class="token punctuation">.</span><span class="token function">toString</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
            dataToSave<span class="token punctuation">[</span><span class="token string">"KEY_ROOM"</span><span class="token punctuation">]</span> <span class="token operator">=</span> editTextRoom<span class="token punctuation">.</span>text<span class="token punctuation">.</span><span class="token function">toString</span><span class="token punctuation">(</span><span class="token punctuation">)</span>

            documentRef<span class="token punctuation">.</span><span class="token function">set</span><span class="token punctuation">(</span>dataToSave<span class="token punctuation">)</span>
                <span class="token punctuation">.</span>addOnSuccessListener <span class="token punctuation">{</span>
                    <span class="token class-name">Log</span><span class="token punctuation">.</span><span class="token function">d</span><span class="token punctuation">(</span><span class="token string">"--------&gt;"</span><span class="token punctuation">,</span> <span class="token string">"FirestoreFragment - initComponent: Add data success!"</span><span class="token punctuation">)</span>
                <span class="token punctuation">}</span>
                <span class="token punctuation">.</span>addOnFailureListener <span class="token punctuation">{</span>
                    <span class="token class-name">Log</span><span class="token punctuation">.</span><span class="token function">d</span><span class="token punctuation">(</span><span class="token string">"--------&gt;"</span><span class="token punctuation">,</span> <span class="token string">"FirestoreFragment - initComponent: Add data failure!"</span><span class="token punctuation">)</span>
                <span class="token punctuation">}</span>
        <span class="token punctuation">}</span>
    <span class="token punctuation">}</span>

private val documentRef = FirebaseFirestore.getInstance().document("sampleData/home")

private fun setEvent() {

btnSend.setOnClickListener {

val dataToSave = HashMap<String, Any>()

dataToSave["KEY_NAME"] = editTextName.text.toString()

dataToSave["KEY_ROOM"] = editTextRoom.text.toString()

documentRef.set(dataToSave)

.addOnSuccessListener {

Log.d("-------->", "FirestoreFragment - initComponent: Add data success!")

}

.addOnFailureListener {

Log.d("-------->", "FirestoreFragment - initComponent: Add data failure!")

}

Dòng đầu tiên là mình tạo một instance của Firebasestore. Nếu chưa có collection và document thì nó sẽ tự tạo ra trên console với tên tương ứng trong code. Cấu trúc collection và document theo format như sau :

Rồi, giờ mình sẽ tạo rule trên console, bạn vào mục Cloud Firestore trên console và click button Create database, sau đó nó sẽ mở ra màn hình cài đặt rule để bảo vệ dữ liệu của bạn, các chế độ là production hay test để mình chọn. Production mode hay còn gọi là Locked mode, chế độ này không cho phép bên thứ 3 có thể đọc và viết, thường dùng cho C#, Go, Java, Node.js, PHP, Python, or Ruby server client library. Test mode thì ngược lại, nó cho phép tất cả mọi người có thể đọc và viết vào database, thường được sử dụng bởi web, iOS, hoặc Android SDK.

Xong nhấn button Next :

Cứ nhấn next cho đến khi hiển thị màn hình loading tạo database, khi xong nó sẽ là màn hình chính của tab Firestore. Sau khi tạo xong thì để ý tab RULES nhé, mình phải sửa để có quyền update database :

rules_version <span class="token operator">=</span> <span class="token string">'2'</span><span class="token punctuation">;</span>
service cloud<span class="token punctuation">.</span>firestore <span class="token punctuation">{</span>
  match <span class="token operator">/</span>databases<span class="token operator">/</span><span class="token punctuation">{</span>database<span class="token punctuation">}</span><span class="token operator">/</span>documents <span class="token punctuation">{</span>
  match <span class="token operator">/</span>sampleData<span class="token operator">/</span><span class="token punctuation">{</span>anything<span class="token operator">=</span><span class="token operator">*</span><span class="token operator">*</span><span class="token punctuation">}</span><span class="token punctuation">{</span>
  allow read<span class="token punctuation">,</span> write<span class="token operator">:</span> <span class="token keyword">if</span> <span class="token boolean">true</span>
  <span class="token punctuation">}</span>
    match <span class="token operator">/</span><span class="token punctuation">{</span>document<span class="token operator">=</span><span class="token operator">*</span><span class="token operator">*</span><span class="token punctuation">}</span> <span class="token punctuation">{</span>
      allow read<span class="token punctuation">,</span> write<span class="token operator">:</span> <span class="token keyword">if</span> <span class="token boolean">false</span>
    <span class="token punctuation">}</span>
  <span class="token punctuation">}</span>
<span class="token punctuation">}</span>

rules_version = '2';

service cloud.firestore {

match /databases/{database}/documents {

match /sampleData/{anything=**}{

allow read, write: if true

}

match /{document=**} {

allow read, write: if false

}

Xong rồi nhấn button PUBLISH :

Rồi mình chạy app và xem kết quả trên console :

Bây giờ mình làm đến phần lấy data từ Firestore về hiển thị trên TextView:

<span class="token keyword">private</span> fun <span class="token function">fetchData</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
        documentRef<span class="token punctuation">.</span><span class="token function">get</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
            <span class="token punctuation">.</span>addOnSuccessListener<span class="token punctuation">{</span> documentSnapshot <span class="token operator">-&gt;</span>
                <span class="token keyword">if</span> <span class="token punctuation">(</span>documentSnapshot<span class="token punctuation">.</span><span class="token function">exists</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
                    val name <span class="token operator">=</span> documentSnapshot<span class="token punctuation">.</span><span class="token function">getString</span><span class="token punctuation">(</span>KEY_NAME<span class="token punctuation">)</span>
                    val room <span class="token operator">=</span> documentSnapshot<span class="token punctuation">.</span><span class="token function">getString</span><span class="token punctuation">(</span>KEY_ROOM<span class="token punctuation">)</span>
                    textFetch<span class="token punctuation">.</span>text <span class="token operator">=</span> <span class="token string">"$name-----$room"</span>
                <span class="token punctuation">}</span>
            <span class="token punctuation">}</span>
            <span class="token punctuation">.</span>addOnFailureListener<span class="token punctuation">{</span>
                <span class="token class-name">Log</span><span class="token punctuation">.</span><span class="token function">d</span><span class="token punctuation">(</span><span class="token string">"--------&gt;"</span><span class="token punctuation">,</span> <span class="token string">"FirestoreFragment - fetchData: Fail!"</span><span class="token punctuation">)</span>
            <span class="token punctuation">}</span>
    <span class="token punctuation">}</span>

private fun fetchData() {

documentRef.get()

.addOnSuccessListener{ documentSnapshot ->

if (documentSnapshot.exists()) {

val name = documentSnapshot.getString(KEY_NAME)

val room = documentSnapshot.getString(KEY_ROOM)

textFetch.text = "$name-----$room"

}

.addOnFailureListener{

Log.d("-------->", "FirestoreFragment - fetchData: Fail!")

}

Khi chạy app lên và nhấn button Fetch là nó sẽ lấy data từ trên Firestore về :

Lắng nghe data update realtime về app, đặt trong onStart() để nó lắng nghe :

override fun <span class="token function">onStart</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
        <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onStart</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
        documentRef<span class="token punctuation">.</span>addSnapshotListener <span class="token punctuation">{</span> snapshot<span class="token punctuation">,</span> e <span class="token operator">-&gt;</span>
            <span class="token keyword">if</span> <span class="token punctuation">(</span>e <span class="token operator">!=</span> <span class="token keyword">null</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
                <span class="token class-name">Log</span><span class="token punctuation">.</span><span class="token function">d</span><span class="token punctuation">(</span><span class="token string">"--------&gt;"</span><span class="token punctuation">,</span> <span class="token string">"FirestoreFragment - Listen fail!"</span><span class="token punctuation">)</span>
                <span class="token keyword">return</span><span class="token annotation punctuation">@addSnapshotListener</span>
            <span class="token punctuation">}</span>

            <span class="token keyword">if</span> <span class="token punctuation">(</span>snapshot <span class="token operator">!=</span> <span class="token keyword">null</span> <span class="token operator">&amp;&amp;</span> snapshot<span class="token punctuation">.</span><span class="token function">exists</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
                val name <span class="token operator">=</span> snapshot<span class="token punctuation">.</span><span class="token function">getString</span><span class="token punctuation">(</span>KEY_NAME<span class="token punctuation">)</span>
                val room <span class="token operator">=</span> snapshot<span class="token punctuation">.</span><span class="token function">getString</span><span class="token punctuation">(</span>KEY_ROOM<span class="token punctuation">)</span>
                textFetch<span class="token punctuation">.</span>text <span class="token operator">=</span> <span class="token string">"$name-----$room"</span>
            <span class="token punctuation">}</span> <span class="token keyword">else</span> <span class="token punctuation">{</span>
                <span class="token class-name">Log</span><span class="token punctuation">.</span><span class="token function">d</span><span class="token punctuation">(</span><span class="token string">"--------&gt;"</span><span class="token punctuation">,</span> <span class="token string">"FirestoreFragment - Data null!"</span><span class="token punctuation">)</span>
            <span class="token punctuation">}</span>
        <span class="token punctuation">}</span>
    <span class="token punctuation">}</span>

override fun onStart() {

super.onStart()

documentRef.addSnapshotListener { snapshot, e ->

if (e != null) {

Log.d("-------->", "FirestoreFragment - Listen fail!")

return@addSnapshotListener

}

if (snapshot != null && snapshot.exists()) {

val name = snapshot.getString(KEY_NAME)

val room = snapshot.getString(KEY_ROOM)

textFetch.text = "$name-----$room"

} else {

Log.d("-------->", "FirestoreFragment - Data null!")

}

kết quả :

Tài liệu tham khảo

Firebase document : https://firebase.google.com/docs/firestore .

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo

Firebase – Android: Cloud Firestore

1. Compare Cloud Firestore and Realtime Database

2. Create and setup a Cloud Firestore

Cài đặt project

Build app example

Tài liệu tham khảo

TikTok trở thành nền tảng mảng xã hội lớn thứ hai ở Nam Phi

Mất giá nhanh nhất sau 9 tháng ra mắt, iPhone 14 Pro Max tiếp tục phá đáy tại Việt Nam

Hướng dẫn sử dụng ngôn ngữ R cho người mới bắt đầu

10 plugin cần thiết của SublimeText dành cho các lập trình viên JavaScript