Android Cloud Firestore - Real-time database

Cloud Firestore是一個靈活，可擴展的數據庫，用於從Firebase和Google Cloud Platform進行移動，Web和服務器開發。與Firebase實時數據庫一樣，它可以通過實時監聽器使您的數據在客戶端應用程序之間保持同步，並為移動和Web提供離線支持，因此您可以構建響應式應用程序，無論網絡延遲或Internet連接如何，都能正常運行。Cloud Firestore還提供與其他Firebase和Google Cloud Platform產品的無縫集成，包括雲功能。


Cloud Firestore目前處於測試Beta階段。


創建Cloud Firestore項目

  1. 打開Firebase控制台並創建一個新項目。
  2. 在“ 數據庫”部分中，單擊“ Cloud Firestore” 的“入門”按鈕。
  3. 選擇Cloud Firestore安全規則的啟動模式：
    測試模式
    適合開始使用移動和Web客戶端庫，但允許任何人讀取和覆蓋您的數據。測試後，請務必查看“ 保護您的數據”部分。
    要開始使用Web，IOS或Android SDK，請選擇測試模式。
    鎖定模式
    拒絕來自移動和Web客戶端的所有讀取和寫入。經過身份驗證的應用程序服務器（C＃，Go，Java，Node.js，PHP，Python或Ruby）仍可以訪問您的數據庫。
    要開始使用C＃，Go，Java，Node.js，PHP，Python或Ruby服務器客戶端庫，請選擇鎖定模式。
  4. 單擊啟用。
Cloud Firestore和App Engine： 您不能在同一項目中同時使用Cloud Firestore和Cloud Datastore，這可能會影響使用App Engine的應用程序。嘗試將Cloud Firestore與其他項目一起使用。

設置您的開發環境

  1. 按照說明 將Firebase添加到您的Android應用中。
  2. 將Cloud Firestore Android庫添加到您的app/build.gradle文件中：
implementation 'com.google.firebase:firebase-firestore:17.1.5'

初始化Cloud Firestore

// Access a Cloud Firestore instance from your Activity
FirebaseFirestore db = FirebaseFirestore.getInstance();

添加數據 

有幾種方法可以將數據寫入Cloud Firestore：
  • Add - 將新文檔添加到集合中。 在這種情況下，Cloud Firestore會自動生成文檔標識符（document identifier）。
  • Set - 在集合中設置文檔的數據，當您使用set()創建一個文檔，必須指定文件創建一個ID。
  • Update - 在集合中更新文檔的數據，更新文檔的某些字段而不覆蓋整個文檔。

Add - 當你使用 set() 去創建一個文檔時，必須指定document id，但有時文檔沒有有意義的ID，讓Cloud Firestore自動為您生成ID更方便。你可以通過調用 add()：

add的參數除了使用Map集合的方式，也可以直接丟入你的類別，例如 .add(new user("ada", "Lovelace", 1815))
// Create a new user with a first and last name
Map<string object=""> user = new HashMap<>();
user.put("first", "Ada");
user.put("last", "Lovelace");
user.put("born", 1815);

// Add a new document with a generated ID
db.collection("users")
        .add(user)
        .addOnSuccessListener(new OnSuccessListener<documentreference>() {
            @Override
            public void onSuccess(DocumentReference documentReference) {
                Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId());
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "Error adding document", e);
            }
        });

Set - 要創建或覆蓋單個文檔，請使用 set() 方法：

Map<string object=""> city = new HashMap<>();
city.put("name", "Los Angeles");
city.put("state", "CA");
city.put("country", "USA");

db.collection("cities").document("LA")
        .set(city)
        .addOnSuccessListener(new OnSuccessListener<void>() {
            @Override
            public void onSuccess(Void aVoid) {
                Log.d(TAG, "DocumentSnapshot successfully written!");
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "Error writing document", e);
            }
        });
如果該文檔不存在，則將創建該文檔。 如果文檔確實存在，則其內容將被新提供的數據覆蓋，除非您指定數據應合併到現有文檔中，如下所示：
// Update one field, creating the document if it does not already exist.
Map<String, Object> data = new HashMap<>();
data.put("capital", true);

db.collection("cities").document("BJ")
        .set(data, SetOptions.merge());
如果您不確定文檔是否存在，請傳遞選項以將新數據與任何現有文檔合併，以避免覆蓋整個文檔。

Update - 要更新文檔的某些字段而不覆蓋整個文檔，請使用 update() 方法：

更新部分字段，如果文檔不存在，則會失敗
DocumentReference washingtonRef = db.collection("cities").document("DC");

// Set the "isCapital" field of the city 'DC'
washingtonRef
        .update("capital", true)
        .addOnSuccessListener(new OnSuccessListener<void>() {
            @Override
            public void onSuccess(Void aVoid) {
                Log.d(TAG, "DocumentSnapshot successfully updated!");
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "Error updating document", e);
            }
        });

Update fields in nested objects - 更新較複雜的物件

如果文檔包含嵌套對象，則在調用update（）時可以使用“點表示法”引用文檔中的嵌套字段： 
// Assume the document contains:
// {
//   name: "Frank",
//   favorites: { food: "Pizza", color: "Blue", subject: "recess" }
//   age: 12
// }
//
// To update age and favorite color:
db.collection("users").document("frank")
        .update(
                "age", 13,
                "favorites.color", "Red"
        );
您還可以將服務器時間戳添加到文檔中的特定字段，以跟踪服務器何時收到更新： 
// If you're using custom Java objects in Android, add an @ServerTimestamp
// annotation to a Date field for your custom object classes. This indicates
// that the Date field should be treated as a server timestamp by the object mapper.
DocumentReference docRef = db.collection("objects").document("some-id");

// Update the timestamp field with the value from the server
Map<String,Object> updates = new HashMap<>();
updates.put("timestamp", FieldValue.serverTimestamp());

docRef.update(updates).addOnCompleteListener(new OnCompleteListener<Void>() {
    // ...
    // ...

Update elements in an array - 更新資料陣列

如果您的文檔包含數組字段，則可以使用 arrayUnion() 和 arrayRemove() 來添加和刪除元素。 arrayUnion() 將元素添加到數組中，但只添加元素。 arrayRemove() 刪除每個給定元素的所有實例。
DocumentReference washingtonRef = db.collection("cities").document("DC");

// Atomically add a new region to the "regions" array field.
washingtonRef.update("regions", FieldValue.arrayUnion("greater_virginia"));

// Atomically remove a region from the "regions" array field.
washingtonRef.update("regions", FieldValue.arrayRemove("east_coast"));

讀取數據

要快速驗證是否已將數據添加到Cloud Firestore，請使用Firebase控制台中的數據查看器 。
您還可以使用“get”方法來檢索整個集合。
db.collection("users")
        .get()
        .addOnCompleteListener(new OnCompleteListener<querysnapshot>() {
            @Override
            public void onComplete(@NonNull Task<querysnapshot> task) {
                if (task.isSuccessful()) {
                    for (QueryDocumentSnapshot document : task.getResult()) {
                        Log.d(TAG, document.getId() + " => " + document.getData());
                    }
                } else {
                    Log.w(TAG, "Error getting documents.", task.getException());
                }
            }
        });

刪除數據

要刪除文檔，請使用delete（）方法：
db.collection("cities").document("DC")
        .delete()
        .addOnSuccessListener(new OnSuccessListener<void>() {
            @Override
            public void onSuccess(Void aVoid) {
                Log.d(TAG, "DocumentSnapshot successfully deleted!");
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "Error deleting document", e);
            }
        });

Delete fields

To delete specific fields from a document, use the FieldValue.delete() method when you update a document:
DocumentReference docRef = db.collection("cities").document("BJ");

// Remove the 'capital' field from the document
Map<String,Object> updates = new HashMap<>();
updates.put("capital", FieldValue.delete());

docRef.update(updates).addOnCompleteListener(new OnCompleteListener<void>() {
    // ...
    // ...


這樣試玩用下來，感覺FireStore更完整，更好用了

留言

張貼留言

這個網誌中的熱門文章

Android - 使用 adb 安装apk

adb就是Android debug bridge的簡寫，用來和模擬器或實機互動的工具，可以參考 官方文件 。 adb在 \sdk\platform-tools 目錄底下，直接點選是無法正常使用的，一定要透過 命令提示字元 。 啟動 命令提示字元 的方法： windowsKey + R，然後輸入cmd.exe。 或是找到命令提示字元的捷徑點開。 啟動後，會看到目前的目錄，請將目錄改到\sdk\platform-tools，方法是輸入cd <path>。 確定目錄在\sdk\platform-tools下面後，輸入adb shell，adb就會 啟動 。 通常我們是要使用adb去安裝apk檔案到手機內。先將手機設定好，開啟debug偵錯，然後透過adb來確認有無連接上手機，輸入： adb devices 。若有連接上的話，會看到手機的序號，是一串字碼，反之，則什麼都沒有。 安裝apk 的方法是， 先把apk檔案放到\sdk\platform-tools下， 或是把目錄改到apk檔案所在的目錄。 然後輸入 adb install name.apk ，就會安裝，安裝完會顯示success。 若是要重新安裝，不須解除安裝，僅需輸入adb install  -r  name.apk。多一個-r。 原文連結如下：http://wisdomskyduan.blogspot.com/2014/10/android-adbapkusb.html
閱讀完整內容

Android ContentProvider 實現多個應用程式共享資料

圖片
這篇文章探討的是如何在 單個 應用程式或者 多個 應用程式間做出 安全的共享資料 功能，此篇會運用到  ContentProvider + SQLite ， ContentProvider為應用間的數據交互提供了一個安全的環境。它準許你把自己的應用數據根據需求開放給其它應用進行 新增(insert)、刪除(delete)、修改(update)、查詢(query) ，而不用擔心直接開放數據庫權限而帶來的安全問題。
閱讀完整內容

Android TextView autosizing 自動調整大小

圖片
遇見問題：當一個控件顯示的文本有點長的時候，可能在屏幕小的設備上就會變得顯示不完整，特別是那種不允許文本省略的按鈕。 最近又有這個需求，並且發現官方已經支持這個自適應大小的TextView了。 Android 8.0（API級別26）允許您指示TextView文本大小自動擴展或收縮，以根據其TextView特徵和邊界填充其佈局。此設置可以更輕鬆地使用動態內容優化不同屏幕上的文本大小。
閱讀完整內容