Lese og skrive Firestore-dokumenter

Bruk .add(data) på en samlingsreferanse for å opprette et nytt dokument med en Firestore-generert ID. Bruk .doc(id).set(data) for å opprette eller overskrive et dokument med en bestemt ID.

Verktøyet firestore.FieldValue.serverTimestamp() angir et tidsstempel på serversiden, slik at alle klienter ser samme opprettelsestidspunkt uavhengig av forskjeller i enhetsklokkene. Bruk alltid servertidsstempler for feltene createdAt og updatedAt.

Kall .get() på en DocumentReference for å hente dokumentet én gang. Resultatet er et DocumentSnapshot. Kontroller snapshot.exists før De leser dataene — hvis dokumentet aldri ble opprettet, er exists false, og snapshot.data() returnerer undefined.

Metoden snapshot.data() returnerer et vanlig JavaScript-objekt med alle feltene i dokumentet. Dokument-ID-en hentes via snapshot.id, ikke via dataobjektet.

Bruk .where(field, operator, value) til å filtrere dokumenter, .orderBy(field, 'desc') til å sortere og .limit(n) til å begrense resultatene. Kjed flere .where-kall for OG-logikk. Kall .get() for å utføre spørringen og motta et QuerySnapshot.

Iterer gjennom resultatene med snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() })). Firestore krever sammensatte indekser for spørringer som filtrerer og sorterer etter ulike felter — Firestore skriver ut en lenke i loggene for å opprette den nødvendige indeksen hvis den mangler.

Bruk .update() til å endre bestemte felter uten å overskrive hele dokumentet. Bare feltene De angir, blir endret — alle andre felter forblir uendret. Dette skiller seg fra .set(), som som standard erstatter hele dokumentet.

Bruk firestore.FieldValue.increment(n) til å øke et numerisk felt atomisk uten å lese det først. Bruk firestore.FieldValue.arrayUnion(item) og arrayRemove(item) til å legge til eller fjerne elementer fra array-felter atomisk.

Kall .delete() på en DocumentReference for å fjerne dokumentet. Dette sletter bare selve dokumentet, ikke eventuelle undersamlinger det inneholder. For å slette undersamlinger må De slette hvert dokument i dem rekursivt — Firestore utfører ikke kaskadesletting automatisk.

Hvis De vil slette ett enkelt felt fra et dokument uten å slette selve dokumentet, bruker De firestore.FieldValue.delete() i et .update()-kall med feltnavnet som nøkkel.

En batch-skriving lar Dem utføre flere opprettings-, oppdaterings- og sletteoperasjoner som én atomisk transaksjon. Enten lykkes alle operasjonene, eller så utføres ingen av dem. Dette er avgjørende for operasjoner som må være konsistente, for eksempel overføring av kreditter mellom brukere.

Opprett en batch med firestore().batch(), legg til operasjoner med batch.set(), batch.update() og batch.delete(), og bekreft deretter med batch.commit(). Batch-operasjoner støtter opptil 500 operasjoner om gangen.

Firestore-sikkerhetsregler styrer hvem som kan lese og skrive dokumenter. Reglene defineres i Firebase console under Firestore > Rules ved hjelp av et deklarativt DSL. request.auth-objektet gir Dem tilgang til den autentiserte brukerens UID i regeluttrykk.

Start alltid med deny all som standard, og tillat uttrykkelig bare det som er nødvendig. En regel som lar en bruker skrive bare til sitt eget brukerdokument, ser slik ut: allow write: if request.auth.uid == userId;

Som standard overskriver .set(data) hele dokumentet. Hvis De vil slå sammen nye data med eksisterende felter i stedet for å overskrive dem, sender De { merge: true } som det andre argumentet.

Dette er nyttig når De vil opprette et dokument hvis det ikke finnes, eller oppdatere det hvis det finnes — uten å kjenne alle feltene det inneholder. Det er et mer fleksibelt alternativ til .update(), som kaster en feil hvis dokumentet ikke finnes.

Firestore har en innebygd lokal hurtigbuffer og legger skrivninger i kø når enheten er frakoblet. Når tilkoblingen gjenopprettes, sender Firestore automatisk de kølagte skrivningene til serveren i riktig rekkefølge. Fra appens perspektiv lykkes skrivningene umiddelbart — brukergrensesnittet oppdateres uten å vente på serveren.

Dette betyr at React Native-appen kan være fullt funksjonell uten internettforbindelse for både lesing og skriving, mens Firestore håndterer synkroniseringen transparent. De kan registrere tilkoblingsstatusen ved hjelp av en NetInfo-lytter hvis De må vise tilkoblingsstatus i brukergrensesnittet.

I denne leksjonen har De lært: Firestores dataformel med samlinger og dokumenter, hvordan De legger til, leser, oppdaterer og sletter dokumenter ved hjelp av React Native Firebase SDK, og hvordan batch-skrivninger sikrer atomiske operasjoner på flere dokumenter. Deretter skal vi legge til sanntidslyttere for å motta direkte Firestore-oppdateringer og konfigurere frakoblet lagring.