Lavora con elenchi di dati su piattaforme Apple

Ottieni un FIRDatabaseReference

Per leggere o scrivere dati dal database, è necessaria un'istanza di FIRDatabaseReference :

Veloce

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
var ref: DatabaseReference!

ref = Database.database().reference()

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
@property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

Lettura e scrittura di liste

Aggiungi a un elenco di dati

Utilizzare il metodo childByAutoId per aggiungere dati a un elenco in applicazioni multiutente. Il metodo childByAutoId genera una chiave univoca ogni volta che viene aggiunto un nuovo figlio al riferimento Firebase specificato. Utilizzando queste chiavi generate automaticamente per ogni nuovo elemento nell'elenco, diversi client possono aggiungere figli 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.

Puoi usare il riferimento ai nuovi dati restituiti dal metodo childByAutoId per ottenere il valore della chiave generata automaticamente dal figlio o impostare i dati per il figlio. La chiamata a 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 fan-out dei dati.

Ascolta gli eventi per bambini

Gli eventi figlio vengono attivati ​​in risposta a operazioni specifiche che si verificano ai 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 le aggiunte a un elenco di elementi. Questo evento viene attivato una volta per ogni figlio esistente e poi di nuovo ogni volta che viene aggiunto un nuovo figlio al percorso specificato. Al listener viene passato uno snapshot contenente i dati del nuovo figlio.
FIRDataEventTypeChildChanged Ascolta le modifiche agli elementi in un elenco. Questo evento viene attivato ogni volta che viene modificato un nodo figlio. Ciò include eventuali modifiche ai discendenti del nodo figlio. Lo snapshot passato al listener di eventi contiene i dati aggiornati per il figlio.
FIRDataEventTypeChildRemoved Ascolta gli elementi 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 figlio. Viene utilizzato con i dati ordinati da 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

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
// 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

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
// 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 di eventi figlio sia il modo consigliato per leggere elenchi di dati, ci sono situazioni in cui l'ascolto di eventi valore su un riferimento di elenco è utile.

L'associazione di un osservatore FIRDataEventTypeValue a un elenco di dati restituirà l'intero elenco di dati come un singolo DataSnapshot, che è quindi possibile eseguire in loop per accedere ai singoli elementi figlio.

Anche quando c'è una sola corrispondenza per la query, lo snapshot è ancora un elenco; contiene solo un singolo elemento. Per accedere all'elemento, è necessario scorrere il risultato in loop:

Veloce

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
_commentsRef.observe(.value) { snapshot in
  for child in snapshot.children {
    ...
  }
}

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
[_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 figlio di un elenco in un'unica operazione, anziché ascoltare gli eventi figlio aggiuntivi aggiunti.

Ordinamento e filtraggio dei dati

È possibile utilizzare la classe FIRDatabaseQuery del database in tempo reale per recuperare i dati ordinati per chiave, per valore o per 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 per valori figlio.
queryOrderedByChild Ordina i risultati in base al valore di una chiave figlio o di un percorso figlio nidificato specificato.

Puoi utilizzare un solo metodo di ordinazione alla volta. Chiamare un metodo order-by più volte nella stessa query genera un errore.

L'esempio seguente mostra come recuperare un elenco dei migliori post di un utente ordinati in base al numero di stelle:

Veloce

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
// My top posts by number of stars
let myTopPostsQuery = ref.child("user-posts").child(getUid()).queryOrdered(byChild: "starCount")

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
// 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 ogni post ha ricevuto. Questa tecnica di utilizzo degli ID come chiavi di indice è chiamata data fan out, puoi saperne di più in Structure Your Database .

La chiamata al metodo queryOrderedByChild specifica la chiave figlio in base alla quale ordinare i risultati. In questo esempio, i post sono ordinati in base al valore del figlio "starCount" in ogni post. Le query possono anche essere ordinate per figli nidificati, nel caso in cui si disponga di dati simili a questo:

"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 dell'elenco in base ai valori nidificati sotto la chiave delle metrics specificando il percorso relativo al figlio nidificato nella nostra chiamata queryOrderedByChild .

Veloce

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
 
let postsByMostPopular = ref.child("posts").queryOrdered(byChild: "metrics/views")

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
 
FIRDatabaseQuery *postsByMostPopular = [[ref child:@"posts"] queryOrderedByChild:@"metrics/views"];

Per ulteriori informazioni su come vengono ordinati altri tipi di dati, vedere Come vengono ordinati i dati della query .

Filtraggio dei dati

Per filtrare i dati, puoi combinare qualsiasi metodo limit o range con un metodo order-by durante la creazione di una query.

Metodo Utilizzo
queryLimitedToFirst Imposta il numero massimo di elementi da restituire dall'inizio dell'elenco ordinato dei risultati.
queryLimitedToLast Imposta il numero massimo di elementi da restituire dalla fine dell'elenco di risultati ordinato.
queryStartingAtValue Restituisci articoli maggiori o uguali alla chiave o al valore specificato, a seconda del metodo di ordinazione scelto.
queryStartingAfterValue Restituisci articoli superiori alla chiave o al valore specificato, a seconda del metodo di ordinazione scelto.
queryEndingAtValue Restituisci articoli inferiori o uguali alla chiave o al valore specificato, a seconda del metodo di ordinazione scelto.
queryEndingBeforeValue Restituisci articoli inferiori alla chiave o al valore specificato, a seconda del metodo di ordinazione scelto.
queryEqualToValue Restituisci articoli uguali alla chiave o al valore specificato, a seconda del metodo di ordinazione scelto.

A differenza dei metodi order-by, puoi 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 elementi figlio 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 di Firebase sono archiviati meno di 100 elementi, viene attivato un callback FIRDataEventTypeChildAdded per ciascun elemento.

Quando gli elementi cambiano, ricevi FIRDataEventTypeChildAdded callback per gli elementi che entrano nella query e FIRDataEventTypeChildRemoved per gli elementi che escono da essa in modo che il numero totale rimanga a 100.

L'esempio seguente mostra come un'app di blogging di esempio potrebbe recuperare un elenco dei 100 post più recenti di tutti gli utenti:

Veloce

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
// 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

Nota: questo prodotto Firebase non è disponibile nella destinazione App Clip.
// 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

Puoi usare queryStartingAtValue , queryStartingAfterValue , queryEndingAtValue , queryEndingBeforeValue e queryEqualToValue per scegliere punti di inizio, fine ed equivalenza arbitrari per le query. Questo può essere utile per impaginare i dati o trovare elementi con figli 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.

  1. I bambini con una chiave che può essere analizzata come un intero a 32 bit vengono prima, ordinati in ordine crescente.
  2. I bambini con un valore stringa come chiave vengono dopo, ordinati lessicograficamente in ordine crescente.

queryOrderedByValue

Quando si usa 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 invece del valore di una chiave figlio specificata.

queryOrderedByChild

Quando si utilizza queryOrderedByChild , i dati che contengono la chiave figlio specificata vengono ordinati come segue:

  1. I bambini con un valore nil per la chiave figlio specificata vengono prima.
  2. Seguono i figli con un valore false per la chiave figlio specificata. Se più figli hanno un valore di false , vengono ordinati lessicograficamente per chiave.
  3. I figli con un valore true per la chiave figlio specificata vengono dopo. Se più figli hanno un valore true , vengono ordinati lessicograficamente per chiave.
  4. I bambini con un valore numerico vengono dopo, ordinati in ordine crescente. Se più figli hanno lo stesso valore numerico per il nodo figlio specificato, vengono ordinati per chiave.
  5. 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.
  6. 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 esci da un ViewController . Se un osservatore non viene rimosso correttamente, continua a sincronizzare i dati con la memoria locale e manterrà 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 metodo removeObserverWithHandle .

Quando si aggiunge 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ù listener a un riferimento al database, ogni listener viene chiamato quando viene generato un evento. Per interrompere la sincronizzazione dei dati in quella posizione, devi rimuovere tutti gli osservatori in una posizione chiamando il metodo removeAllObservers .

La chiamata removeObserverWithHandle o removeAllObservers su un listener non rimuove automaticamente i listener registrati sui suoi nodi figlio; devi anche tenere traccia di quei riferimenti o handle per rimuoverli.

Prossimi passi