Ottieni un riferimento FIRDatabase
Per leggere o scrivere dati dal database, è necessaria un'istanza di FIRDatabaseReference
:
Veloce
var ref: DatabaseReference! ref = Database.database().reference()
Obiettivo-C
@property (strong, nonatomic) FIRDatabaseReference *ref; self.ref = [[FIRDatabase database] reference];
Lettura e scrittura di elenchi
Aggiungi a un elenco di dati
Utilizzare il metodo childByAutoId
per aggiungere dati a un elenco nelle applicazioni multiutente. Il metodo childByAutoId
genera una chiave univoca ogni volta che un nuovo figlio viene aggiunto al riferimento Firebase specificato. Utilizzando queste chiavi generate automaticamente per ogni nuovo elemento nell'elenco, diversi client possono aggiungere elementi secondari nella stessa posizione contemporaneamente senza conflitti di scrittura. La chiave univoca generata da childByAutoId
si basa su un timestamp, quindi gli elementi dell'elenco vengono automaticamente ordinati cronologicamente.
È possibile utilizzare il riferimento ai nuovi dati restituiti dal metodo childByAutoId
per ottenere il valore della chiave generata automaticamente del figlio o impostare i dati per il figlio. La chiamata getKey
su un riferimento childByAutoId
restituisce la chiave generata automaticamente.
Puoi utilizzare queste chiavi generate automaticamente per semplificare l'appiattimento della struttura dei dati. Per ulteriori informazioni, vedere l' esempio di distribuzione dei dati.
Ascolta gli eventi per bambini
Gli eventi figlio vengono attivati in risposta a operazioni specifiche che si verificano sui figli di un nodo da un'operazione come un nuovo figlio aggiunto tramite il metodo childByAutoId
o un figlio aggiornato tramite il metodo updateChildValues
.
Tipo di evento | Utilizzo tipico |
---|---|
FIRDataEventTypeChildAdded | Recupera elenchi di elementi o ascolta eventuali aggiunte a un elenco di elementi. Questo evento viene attivato una volta per ogni figlio esistente e poi di nuovo ogni volta che un nuovo figlio viene aggiunto al percorso specificato. All'ascoltatore viene passata un'istantanea contenente i dati del nuovo figlio. |
FIRDataEventTypeChildChanged | Ascolta le modifiche agli elementi in un elenco. Questo evento viene attivato ogni volta che un nodo figlio viene modificato. Ciò include qualsiasi modifica ai discendenti del nodo figlio. Lo snapshot passato al listener di eventi contiene i dati aggiornati per il bambino. |
FIRDataEventTypeChildRemoved | Ascolta gli elementi che vengono rimossi da un elenco. Questo evento viene attivato quando viene rimosso un figlio immediato. Lo snapshot passato al blocco di callback contiene i dati per il figlio rimosso. |
FIRDataEventTypeChildMoved | Ascolta le modifiche all'ordine degli elementi in un elenco ordinato. Questo evento viene attivato ogni volta che un aggiornamento provoca il riordino del bambino. Viene utilizzato con i dati ordinati per queryOrderedByChild o queryOrderedByValue . |
Ognuno di questi insieme può essere utile per ascoltare le modifiche a un nodo specifico in un database. Ad esempio, un'app di social blogging potrebbe utilizzare questi metodi insieme per monitorare l'attività nei commenti di un post, come mostrato di seguito:
Veloce
// Listen for new comments in the Firebase database commentsRef.observe(.childAdded, with: { (snapshot) -> Void in self.comments.append(snapshot) self.tableView.insertRows( at: [IndexPath(row: self.comments.count - 1, section: self.kSectionComments)], with: UITableView.RowAnimation.automatic ) }) // Listen for deleted comments in the Firebase database commentsRef.observe(.childRemoved, with: { (snapshot) -> Void in let index = self.indexOfMessage(snapshot) self.comments.remove(at: index) self.tableView.deleteRows( at: [IndexPath(row: index, section: self.kSectionComments)], with: UITableView.RowAnimation.automatic ) })
Obiettivo-C
// Listen for new comments in the Firebase database [_commentsRef observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) { [self.comments addObject:snapshot]; [self.tableView insertRowsAtIndexPaths:@[ [NSIndexPath indexPathForRow:self.comments.count - 1 inSection:kSectionComments] ] withRowAnimation:UITableViewRowAnimationAutomatic]; }]; // Listen for deleted comments in the Firebase database [_commentsRef observeEventType:FIRDataEventTypeChildRemoved withBlock:^(FIRDataSnapshot *snapshot) { int index = [self indexOfMessage:snapshot]; [self.comments removeObjectAtIndex:index]; [self.tableView deleteRowsAtIndexPaths:@[[NSIndexPath indexPathForRow:index inSection:kSectionComments]] withRowAnimation:UITableViewRowAnimationAutomatic]; }];
Ascolta gli eventi di valore
Sebbene l'ascolto degli eventi figlio sia il modo consigliato per leggere elenchi di dati, in alcune situazioni è utile ascoltare gli eventi valore in un riferimento a un elenco.
Il collegamento di un osservatore FIRDataEventTypeValue
a un elenco di dati restituirà l'intero elenco di dati come un singolo DataSnapshot, su cui è quindi possibile eseguire il loop per accedere ai singoli elementi secondari.
Anche quando esiste una sola corrispondenza per la query, lo snapshot è pur sempre un elenco; contiene solo un singolo elemento. Per accedere all'elemento, è necessario eseguire il loop del risultato:
Veloce
_commentsRef.observe(.value) { snapshot in for child in snapshot.children { ... } }
Obiettivo-C
[_commentsRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) { // Loop over children NSEnumerator *children = [snapshot children]; FIRDataSnapshot *child; while (child = [children nextObject]) { // ... } }];
Questo modello può essere utile quando si desidera recuperare tutti gli elementi secondari di un elenco in un'unica operazione, anziché attendere ulteriori eventi secondari aggiunti.
Ordinamento e filtraggio dei dati
È possibile utilizzare la classe FIRDatabaseQuery
di Realtime Database per recuperare i dati ordinati per chiave, valore o valore di un figlio. Puoi anche filtrare il risultato ordinato in base a un numero specifico di risultati o a un intervallo di chiavi o valori.
Ordina i dati
Per recuperare i dati ordinati, inizia specificando uno dei metodi order-by per determinare come vengono ordinati i risultati:
Metodo | Utilizzo |
---|---|
queryOrderedByKey | Ordina i risultati per chiavi figlio. |
queryOrderedByValue | Ordina i risultati in base ai valori secondari. |
queryOrderedByChild | Ordina i risultati in base al valore di una chiave figlio specificata o di un percorso figlio nidificato. |
Puoi utilizzare un solo metodo di ordine alla volta. La chiamata di un metodo order-by più volte nella stessa query genera un errore.
L'esempio seguente dimostra come recuperare un elenco dei post principali di un utente ordinati in base al numero di stelle:
Veloce
// My top posts by number of stars let myTopPostsQuery = ref.child("user-posts").child(getUid()).queryOrdered(byChild: "starCount")
Obiettivo-C
// My top posts by number of stars FIRDatabaseQuery *myTopPostsQuery = [[[self.ref child:@"user-posts"] child:[super getUid]] queryOrderedByChild:@"starCount"];
Questa query recupera i post dell'utente dal percorso nel database in base al suo ID utente, ordinato in base al numero di stelle che ciascun post ha ricevuto. Questa tecnica di utilizzo degli ID come chiavi di indice è chiamata fan out dei dati, puoi leggere ulteriori informazioni in Struttura il tuo database .
La chiamata al metodo queryOrderedByChild
specifica la chiave figlio in base alla quale ordinare i risultati. In questo esempio, i post vengono ordinati in base al valore del figlio "starCount"
in ciascun post. Le query possono anche essere ordinate per figli nidificati, nel caso in cui si disponga di dati simili a questi:
"posts": { "ts-functions": { "metrics": { "views" : 1200000, "likes" : 251000, "shares": 1200, }, "title" : "Why you should use TypeScript for writing Cloud Functions", "author": "Doug", }, "android-arch-3": { "metrics": { "views" : 900000, "likes" : 117000, "shares": 144, }, "title" : "Using Android Architecture Components with Firebase Realtime Database (Part 3)", "author": "Doug", } },
In questo caso, possiamo ordinare gli elementi della nostra lista in base ai valori nidificati sotto la chiave metrics
specificando il percorso relativo al figlio nidificato nella nostra chiamata queryOrderedByChild
.
Veloce
let postsByMostPopular = ref.child("posts").queryOrdered(byChild: "metrics/views")
Obiettivo-C
FIRDatabaseQuery *postsByMostPopular = [[ref child:@"posts"] queryOrderedByChild:@"metrics/views"];
Per ulteriori informazioni su come vengono ordinati gli altri tipi di dati, vedere Come vengono ordinati i dati delle query .
Filtraggio dei dati
Per filtrare i dati, è possibile combinare qualsiasi metodo di limite o intervallo con un metodo di ordinamento durante la costruzione di una query.
Metodo | Utilizzo |
---|---|
queryLimitedToFirst | Imposta il numero massimo di elementi da restituire dall'inizio dell'elenco ordinato di risultati. |
queryLimitedToLast | Imposta il numero massimo di elementi da restituire dalla fine dell'elenco ordinato di risultati. |
queryStartingAtValue | Restituisce elementi maggiori o uguali alla chiave o al valore specificato, a seconda del metodo di ordine scelto. |
queryStartingAfterValue | Restituisce elementi maggiori della chiave o del valore specificato, a seconda del metodo di ordine scelto. |
queryEndingAtValue | Restituisce elementi inferiori o uguali alla chiave o al valore specificato, a seconda del metodo di ordine scelto. |
queryEndingBeforeValue | Restituisce gli elementi inferiori alla chiave o al valore specificato, a seconda del metodo di ordine scelto. |
queryEqualToValue | Restituisce elementi uguali alla chiave o al valore specificato, a seconda del metodo di ordine scelto. |
A differenza dei metodi ordinati, è possibile combinare più funzioni di limite o intervallo. Ad esempio, puoi combinare i metodi queryStartingAtValue
e queryEndingAtValue
per limitare i risultati a un intervallo di valori specificato.
Limita il numero di risultati
È possibile utilizzare i metodi queryLimitedToFirst
e queryLimitedToLast
per impostare un numero massimo di figli da sincronizzare per un determinato callback. Ad esempio, se utilizzi queryLimitedToFirst
per impostare un limite di 100, inizialmente riceverai solo fino a 100 callback FIRDataEventTypeChildAdded
. Se nel database Firebase sono archiviati meno di 100 elementi, viene attivato un callback FIRDataEventTypeChildAdded
per ciascun elemento.
Man mano che gli elementi cambiano, ricevi callback FIRDataEventTypeChildAdded
per gli elementi che inseriscono la query e callback FIRDataEventTypeChildRemoved
per gli elementi che ne escono in modo che il numero totale rimanga su 100.
L'esempio seguente dimostra come un'app di blogging di esempio potrebbe recuperare un elenco dei 100 post più recenti di tutti gli utenti:
Veloce
// Last 100 posts, these are automatically the 100 most recent // due to sorting by push() keys let recentPostsQuery = (ref?.child("posts").queryLimited(toFirst: 100))!
Obiettivo-C
// Last 100 posts, these are automatically the 100 most recent // due to sorting by push() keys FIRDatabaseQuery *recentPostsQuery = [[self.ref child:@"posts"] queryLimitedToFirst:100];
Filtra per chiave o valore
È possibile utilizzare queryStartingAtValue
, queryStartingAfterValue
, queryEndingAtValue
, queryEndingBeforeValue
e queryEqualToValue
per scegliere punti iniziali, finali ed equivalenti arbitrari per le query. Ciò può essere utile per impaginare i dati o trovare elementi con elementi secondari che hanno un valore specifico.
Come vengono ordinati i dati della query
Questa sezione spiega come i dati vengono ordinati in base a ciascuno dei metodi order-by nella classe FIRDatabaseQuery
.
queryOrderedByKey
Quando si utilizza queryOrderedByKey
per ordinare i dati, i dati vengono restituiti in ordine crescente per chiave.
- I figli con una chiave che può essere analizzata come intero a 32 bit vengono prima, ordinati in ordine crescente.
- Seguono i bambini con un valore stringa come chiave, ordinati lessicograficamente in ordine crescente.
queryOrderedByValue
Quando si utilizza queryOrderedByValue
, i bambini vengono ordinati in base al loro valore. I criteri di ordinamento sono gli stessi di queryOrderedByChild
, tranne per il fatto che viene utilizzato il valore del nodo anziché il valore di una chiave figlio specificata.
queryOrderedByChild
Quando si utilizza queryOrderedByChild
, i dati che contengono la chiave figlio specificata vengono ordinati come segue:
- I bambini con un valore
nil
per la chiave figlio specificata vengono prima. - I figli con un valore
false
per la chiave figlio specificata vengono dopo. Se più figli hanno un valorefalse
, vengono ordinati lessicograficamente per chiave. - I figli con un valore
true
per la chiave figlio specificata vengono dopo. Se più figli hanno un valoretrue
, vengono ordinati lessicograficamente per chiave. - Seguono i bambini con un valore numerico, ordinati in ordine crescente. Se più figli hanno lo stesso valore numerico per il nodo figlio specificato, vengono ordinati per chiave.
- Le stringhe vengono dopo i numeri e sono ordinate lessicograficamente in ordine crescente. Se più figli hanno lo stesso valore per il nodo figlio specificato, vengono ordinati lessicograficamente per chiave.
- Gli oggetti vengono per ultimi e sono ordinati lessicograficamente per chiave in ordine crescente.
Distacca gli ascoltatori
Gli osservatori non interrompono automaticamente la sincronizzazione dei dati quando lasci un ViewController
. Se un osservatore non viene rimosso correttamente, continua a sincronizzare i dati nella memoria locale e conserverà tutti gli oggetti acquisiti nella chiusura del gestore eventi, il che può causare perdite di memoria. Quando un osservatore non è più necessario, rimuoverlo passando il FIRDatabaseHandle
associato al removeObserverWithHandle
.
Quando aggiungi un blocco di callback a un riferimento, viene restituito un FIRDatabaseHandle
. Questi handle possono essere utilizzati per rimuovere il blocco di callback.
Se sono stati aggiunti più ascoltatori a un riferimento al database, ogni ascoltatore viene chiamato quando viene generato un evento. Per interrompere la sincronizzazione dei dati in quella posizione, è necessario rimuovere tutti gli osservatori in una posizione chiamando il removeAllObservers
.
La chiamata removeObserverWithHandle
removeAllObservers
su un ascoltatore non rimuove automaticamente gli ascoltatori registrati sui suoi nodi figli; è inoltre necessario tenere traccia di tali riferimenti o handle per rimuoverli.