Läsa och skriva Firestore-dokument

Använd .add(data) på en samlingsreferens för att skapa ett nytt dokument med ett ID som genereras av Firestore. Använd .doc(id).set(data) för att skapa eller skriva över ett dokument med ett specifikt ID.

Verktyget firestore.FieldValue.serverTimestamp() anger en tidsstämpel på serversidan, vilket säkerställer att alla klienter ser samma skapandetid oavsett skillnader mellan enheternas klockor. Använd alltid servertidsstämplar för fälten createdAt och updatedAt.

Anropa .get() på en DocumentReference för att hämta dokumentet en gång. Resultatet är en DocumentSnapshot. Kontrollera snapshot.exists innan Ni läser data – om dokumentet aldrig har skapats är exists false och snapshot.data() returnerar undefined.

Metoden snapshot.data() returnerar ett vanligt JavaScript-objekt med dokumentets alla fält. Dokument-ID:t nås via snapshot.id, inte via dataobjektet.

Använd .where(field, operator, value) för att filtrera dokument, .orderBy(field, 'desc') för att sortera och .limit(n) för att begränsa antalet resultat. Kedja flera anrop av .where för AND-logik. Anropa .get() för att köra frågan och ta emot en QuerySnapshot.

Iterera över resultaten med snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() })). Firestore kräver sammansatta index för frågor som filtrerar och sorterar efter olika fält – om ett index saknas skriver Firestore ut en länk i loggarna där Ni kan skapa det index som krävs.

Använd .update() för att ändra specifika fält utan att skriva över hela dokumentet. Endast de fält Ni anger ändras – alla andra fält förblir oförändrade. Detta skiljer sig från .set(), som som standard ersätter hela dokumentet.

Använd firestore.FieldValue.increment(n) för att atomiskt öka ett numeriskt fält utan att först läsa det. Använd firestore.FieldValue.arrayUnion(item) och arrayRemove(item) för att atomiskt lägga till eller ta bort objekt i arrayfält.

Anropa .delete() på en DocumentReference för att ta bort dokumentet. Detta tar endast bort själva dokumentet, inte eventuella undersamlingar som det innehåller. Om Ni vill ta bort undersamlingar måste Ni ta bort varje dokument i dem rekursivt – Firestore kaskadraderar inte automatiskt.

Om Ni vill ta bort ett enskilt fält från ett dokument utan att ta bort själva dokumentet använder Ni firestore.FieldValue.delete() i ett anrop av .update(), med fältnamnet som nyckel.

En batchskrivning låter Er utföra flera skapande-, uppdaterings- och borttagningsåtgärder som en enda atomisk transaktion. Antingen lyckas alla åtgärder eller också ingen av dem. Detta är viktigt för åtgärder som måste förbli konsekventa, till exempel när krediter överförs mellan användare.

Skapa en batch med firestore().batch(), lägg till åtgärder med batch.set(), batch.update() och batch.delete() och verkställ sedan med batch.commit(). Batchar har stöd för upp till 500 åtgärder samtidigt.

Firestore-säkerhetsregler styr vem som får läsa och skriva dokument. Reglerna definieras i Firebase-konsolen under Firestore > Rules med ett deklarativt DSL. Objektet request.auth ger Er tillgång till den autentiserade användarens UID i regeluttryck.

Börja alltid med neka alla som standard och tillåt uttryckligen endast det som behövs. En regel som endast tillåter en användare att skriva till sitt eget användardokument ser ut så här: allow write: if request.auth.uid == userId;

Som standard skriver .set(data) över hela dokumentet. Om Ni vill slå samman nya data med befintliga fält i stället för att skriva över dem skickar Ni { merge: true } som det andra argumentet.

Detta är användbart när Ni vill skapa ett dokument om det inte finns, eller uppdatera det om det finns – utan att känna till alla dess aktuella fält. Det är ett mer flexibelt alternativ till .update(), som kastar ett fel om dokumentet inte finns.

Firestore har en inbyggd lokal cache och köar skrivningar när enheten är offline. När anslutningen återkommer skickar Firestore automatiskt de köade skrivningarna till servern i rätt ordning. Ur appens perspektiv lyckas skrivningarna omedelbart – gränssnittet uppdateras utan att vänta på servern.

Det innebär att Er React Native-app kan fortsätta fungera fullt ut utan internetanslutning för läsningar och skrivningar, medan Firestore hanterar synkroniseringen transparent. Ni kan identifiera online- och offlinestatus med en NetInfo-lyssnare om Ni behöver visa anslutningsstatus i gränssnittet.

I den här lektionen har Ni lärt Er: Firestores data­modell med samlingar och dokument, hur man lägger till, läser, uppdaterar och tar bort dokument med React Native Firebase SDK samt hur batchskrivningar säkerställer atomiska åtgärder över flera dokument. Härnäst lägger vi till realtidslyssnare för att ta emot liveuppdateringar från Firestore och konfigurerar offline-persistens.