Menangani Daftar Data

Mendapatkan referensi database

Untuk membaca atau menulis data dari database, Anda memerlukan instance DatabaseReference:

DatabaseReference ref = FirebaseDatabase.instance.ref();

Catatan: Secara default, akses baca dan tulis ke database Anda dibatasi, sehingga hanya pengguna terautentikasi yang dapat membaca atau menulis data. Untuk memulai tanpa menyiapkan Firebase Authentication, Anda dapat mengonfigurasi aturan untuk akses publik. Tindakan ini membuat database terbuka bagi siapa saja, termasuk orang yang tidak menggunakan aplikasi Anda. Oleh sebab itu, pastikan untuk kembali membatasi database Anda saat menyiapkan autentikasi.

Membaca dan menulis daftar

Menambahi daftar data

Gunakan metode push() untuk menambahkan data ke daftar dalam aplikasi multi-pengguna. Metode push() menghasilkan kunci unik setiap kali turunan baru ditambahkan ke referensi Firebase tertentu. Dengan menggunakan kunci yang dihasilkan secara otomatis untuk setiap elemen baru dalam daftar, beberapa klien dapat menambahkan turunan ke lokasi yang sama secara bersamaan tanpa ada konflik tulis. Kunci unik yang dihasilkan oleh push() didasarkan pada stempel waktu, sehingga item daftar akan otomatis diurutkan secara kronologis.

Anda dapat menggunakan referensi ke data baru yang ditampilkan oleh metode push() untuk mendapatkan nilai kunci turunan yang dihasilkan otomatis atau menetapkan data untuk turunan. Properti .key dari referensi push() berisi kunci yang dihasilkan secara otomatis.

Anda dapat menggunakan kunci yang dihasilkan secara otomatis ini untuk mempermudah perataan struktur data. Untuk mengetahui informasi lebih lanjut, lihat contoh fan-out data.

Misalnya, push() dapat digunakan untuk menambahkan postingan baru ke daftar postingan di aplikasi sosial:

DatabaseReference postListRef = FirebaseDatabase.instance.ref("posts");
DatabaseReference newPostRef = postListRef.push();
newPostRef.set({
  // ...
});

Memproses peristiwa turunan

Peristiwa turunan dipicu sebagai respons terhadap operasi tertentu yang terjadi pada turunan node dari suatu operasi, seperti turunan baru yang ditambahkan melalui metode push() atau turunan yang diperbarui melalui metode update().

Peristiwa	Penggunaan standar
onChildAdded	Mengambil daftar item atau memproses penambahan ke daftar item. Peristiwa ini dipicu satu kali untuk setiap turunan yang ada, dan dipicu lagi setiap kali ada turunan baru yang ditambahkan ke jalur yang ditentukan. Snapshot yang berisi data turunan baru akan diteruskan ke pemroses.
onChildChanged	Memproses perubahan pada item dalam daftar. Peristiwa ini dipicu setiap kali node turunan diubah. Ini juga termasuk perubahan pada turunan node turunan. Snapshot yang diteruskan ke pemroses peristiwa berisi data turunan yang diperbarui.
onChildRemoved	Memproses item yang dihapus dari daftar. Peristiwa ini dipicu ketika suatu turunan langsung dihapus. Snapshot yang diteruskan ke blok callback berisi data turunan yang dihapus.
onChildMoved	Memproses perubahan urutan item dalam daftar yang diurutkan. Peristiwa onChildMoved selalu mengikuti peristiwa onChildChanged yang menyebabkan urutan item berubah (berdasarkan metode 'urutkan menurut' saat ini).

Secara bersama-sama, setiap metode ini dapat berguna untuk memproses perubahan terhadap node tertentu dalam database. Misalnya, aplikasi blogging sosial mungkin menggunakan metode ini secara bersama-sama untuk memantau aktivitas dalam komentar suatu postingan, seperti terlihat di bawah ini:

final commentsRef = FirebaseDatabase.instance.ref("post-comments/$postId");
commentsRef.onChildAdded.listen((event) {
  // A new comment has been added, so add it to the displayed list.
});
commentsRef.onChildChanged.listen((event) {
  // A comment has changed; use the key to determine if we are displaying this
  // comment and if so displayed the changed comment.
});
commentsRef.onChildRemoved.listen((event) {
  // A comment has been removed; use the key to determine if we are displaying
  // this comment and if so remove it.
});

Mendeteksi peristiwa nilai

Meskipun memproses peristiwa turunan adalah cara yang disarankan untuk membaca daftar data, memproses peristiwa nilai di referensi daftar dapat pula bermanfaat.

Menyertakan pemroses value ke daftar data akan menampilkan keseluruhan daftar data sebagai snapshot tunggal, yang nantinya dapat di-loop untuk mengakses setiap turunan.

Meskipun hanya ada satu kueri yang cocok, snapshot tetaplah sebuah daftar yang berisi satu item. Untuk mengakses item tersebut, Anda harus melakukan loop pada hasil:

myTopPostsQuery.onValue.listen((event) {
  for (final child in event.snapshot.children) {
    // Handle the post.
  }
}, onError: (error) {
  // Error.
});

Pola ini dapat bermanfaat ketika Anda ingin mengambil semua turunan daftar dalam operasi tunggal, bukannya memproses peristiwa penambahan turunan lain.

Mengurutkan dan memfilter data

Anda dapat menggunakan class Query untuk memperoleh data yang diurutkan berdasarkan kunci, nilai, atau nilai turunan. Anda juga dapat memfilter hasil pengurutan berdasarkan jumlah hasil tertentu atau berdasarkan rentang kunci atau nilai.

Catatan: Biaya pemfilteran dan pengurutan bisa menjadi mahal, terutama jika dilakukan pada klien. Jika aplikasi Anda menggunakan kueri, tentukan aturan .indexOn untuk mengindeks kunci tersebut pada server dan meningkatkan performa kueri, seperti yang dijelaskan dalam artikel Mengindeks Data.

Mengurutkan data

Untuk mengambil data yang diurutkan, mulai dengan menentukan salah satu metode 'urutkan menurut' guna menentukan cara pengurutan hasil:

Metode	Penggunaan
orderByChild()	Mengurutkan hasil menurut nilai kunci turunan atau jalur turunan bertingkat yang ditentukan.
orderByKey()	Mengurutkan hasil menurut kunci turunan.
orderByValue()	Mengurutkan hasil menurut nilai turunan.

Anda hanya bisa menggunakan satu metode 'urutkan menurut' pada satu waktu. Memanggil metode 'urutkan menurut' beberapa kali dalam kueri yang sama akan menampilkan error.

Contoh berikut menunjukkan cara mengambil daftar postingan teratas milik pengguna yang diurutkan berdasarkan jumlah bintangnya:

final myUserId = FirebaseAuth.instance.currentUser?.uid;
final topUserPostsRef = FirebaseDatabase.instance
    .ref("user-posts/$myUserId")
    .orderByChild("starCount");

Contoh ini menentukan kueri yang, jika dikombinasikan dengan pemroses turunan, akan menyinkronkan klien dengan postingan pengguna dari jalur dalam database berdasarkan ID penggunanya, yang diurutkan menurut jumlah bintang yang diterima setiap postingan. Teknik penggunaan ID sebagai kunci indeks ini disebut fan-out data. Anda dapat membaca hal ini lebih lanjut di bagian Membuat Struktur Database.

Panggilan ke metode orderByChild() menentukan kunci turunan sebagai dasar pengurutan hasil. Dalam kasus ini, postingan diurutkan berdasarkan nilai turunan "starCount" masing-masing. Kueri juga dapat diurutkan berdasarkan turunan bertingkat, jika Anda memiliki data yang tampak seperti ini:

"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",
  }
},

Dalam kasus ini, kita dapat mengurutkan elemen daftar berdasarkan nilai bertingkat dalam kunci metrics dengan menentukan jalur relatif ke turunan bertingkat pada panggilan orderByChild().

final mostViewedPosts =
    FirebaseDatabase.instance.ref('posts').orderByChild('metrics/views');

Untuk informasi lebih lanjut mengenai metode pengurutan jenis data lainnya, lihat Metode pengurutan data kueri.

Memfilter data

Untuk memfilter data, Anda dapat menggabungkan salah satu metode batas atau rentang dengan metode 'urutkan menurut' ketika menyusun kueri.

Catatan: Anda tidak boleh menggunakan karakter Unicode khusus di kunci Anda, seperti \u{0000}. Lihat masalah Flutter untuk detail selengkapnya.

Metode	Penggunaan
limitToFirst()	Menetapkan jumlah item maksimum untuk ditampilkan dari awal daftar hasil yang diurutkan.
limitToLast()	Menetapkan jumlah item maksimum untuk ditampilkan dari akhir daftar hasil yang diurutkan.
startAt()	Menampilkan item yang lebih besar dari atau sama dengan kunci atau nilai yang ditentukan, tergantung metode 'urutkan menurut' yang dipilih.
startAfter()	Menampilkan item yang lebih besar dari kunci atau nilai yang ditentukan, tergantung metode 'urutkan menurut' yang dipilih.
endAt()	Menampilkan item yang lebih kecil dari atau sama dengan kunci atau nilai yang ditentukan, tergantung metode 'urutkan menurut' yang dipilih.
endBefore()	Menampilkan item yang lebih kecil dari kunci atau nilai yang ditentukan, tergantung metode 'urutkan menurut' yang dipilih.
equalTo()	Menampilkan item yang sama dengan kunci atau nilai yang ditentukan, tergantung metode 'urutkan menurut' yang dipilih.

Berbeda dengan metode 'urutkan menurut', Anda dapat menggabungkan beberapa fungsi batas atau rentang. Misalnya, Anda dapat menggabungkan metode startAt() dan endAt() untuk membatasi hasil pada rentang nilai tertentu.

Membatasi jumlah hasil

Anda dapat menggunakan metode limitToFirst() dan limitToLast() untuk menetapkan jumlah turunan maksimum yang akan disinkronkan untuk peristiwa tertentu. Misalnya, jika Anda menggunakan limitToFirst() untuk menetapkan batas 100, pada awalnya Anda hanya akan menerima hingga 100 peristiwa onChildAdded. Jika kurang dari 100 item tersimpan dalam database Firebase, peristiwa onChildAdded akan diaktifkan untuk setiap item.

Saat item berubah, Anda akan menerima peristiwa onChildAdded untuk item yang masuk ke kueri dan peristiwa onChildRemoved untuk item yang keluar dari kueri, sehingga jumlah totalnya tetap 100.

Contoh berikut menunjukkan cara aplikasi blogging menentukan kueri untuk mengambil daftar dari 100 postingan terbaru oleh semua pengguna:

final recentPostsRef = FirebaseDatabase.instance.ref('posts').limitToLast(100);

Contoh ini hanya menetapkan kueri. Untuk dapat benar-benar menyinkronkan data, perlu ada pemroses yang terpasang.

Memfilter berdasarkan kunci atau nilai

Anda dapat menggunakan startAt(), startAfter(), endAt(), endBefore(), dan equalTo() untuk memilih titik awal, akhir, dan ekuivalensi yang arbitrer untuk kueri. Hal ini dapat bermanfaat untuk pengelompokan halaman data atau menemukan item dengan turunan yang memiliki nilai tertentu.

Cara pengurutan data kueri

Bagian ini menjelaskan cara pengurutan data menggunakan setiap metode 'urutkan menurut' di class Query.

orderByChild

Jika Anda menggunakan orderByChild(), data yang berisi kunci turunan yang ditentukan akan diurutkan sebagai berikut:

1. Turunan yang memiliki nilai null untuk kunci turunan yang ditentukan akan muncul terlebih dahulu.
2. Turunan yang memiliki nilai false untuk kunci turunan yang ditentukan akan muncul berikutnya. Jika beberapa turunan memiliki nilai false, turunan tersebut akan diurutkan secara leksikografis menurut kunci.
3. Turunan yang memiliki nilai true untuk kunci turunan yang ditentukan akan muncul berikutnya. Jika beberapa turunan memiliki nilai true, turunan tersebut akan diurutkan secara leksikografis menurut kunci.
4. Turunan dengan nilai numerik akan muncul berikutnya, dan diurutkan menaik. Jika beberapa turunan memiliki nilai numerik yang sama untuk node turunan yang ditentukan, turunan tersebut akan diurutkan menurut kunci.
5. String muncul setelah angka, dan diurutkan secara leksikografis menaik. Jika beberapa turunan memiliki nilai yang sama untuk node turunan yang ditentukan, turunan tersebut akan diurutkan secara leksikografis menurut kunci.
6. Objek akan muncul terakhir, dan diurutkan secara leksikografis menaik menurut kunci.

orderByKey

Data yang diurutkan menggunakan orderByKey() akan ditampilkan dalam urutan menaik menurut kunci.

1. Turunan dengan kunci yang bisa diurai sebagai bilangan bulat 32-bit akan muncul terlebih dahulu, dan diurutkan menaik.
2. Turunan dengan nilai string sebagai kuncinya akan muncul berikutnya, dan diurutkan secara leksikografis menaik.

orderByValue

Jika menggunakan orderByValue(), turunan akan diurutkan menurut nilainya. Kriteria urutan sama seperti di orderByChild(), tetapi yang digunakan adalah nilai node, bukan nilai kunci turunan yang ditentukan.

Melepas pemroses

Callback akan dihapus dengan memanggil metode off() pada referensi database Firebase.

Anda dapat menghapus sebuah pemroses dengan meneruskannya sebagai parameter ke off(). Memanggil off() pada lokasi tanpa argumen akan menghapus semua pemroses yang ada di lokasi tersebut.

Memanggil off() pada pemroses induk tidak akan otomatis menghapus pemroses yang terdaftar pada node turunannya. off() juga harus dipanggil pada pemroses turunan mana pun untuk menghapus callback.

Langkah berikutnya

• Mempelajari cara membuat struktur data
• Menyimpan data secara offline