C++ için Firebase Gerçek Zamanlı Veritabanıyla Veri Alma

Bu belge, veri almanın temellerini ve Firebase verilerinin nasıl sıralanıp filtreleneceğini kapsar.

Sen başlamadan önce

Uygulamanızı kurduğunuzdan ve Get Started ​​kılavuzunda anlatıldığı gibi veritabanına erişebildiğinizden emin olun.

Veri Alma

Firebase verileri GetValue() ye yapılan tek seferlik bir çağrıyla veya FirebaseDatabase referansındaki bir ValueListener eklenerek alınır. Değer dinleyicisi, verilerin ilk durumu için bir kez ve veriler değiştiğinde tekrar çağrılır.

Veritabanı Referansı Alın

Veritabanına veri yazmak için bir DatabaseReference örneğine ihtiyacınız vardır:

    // Get the root reference location of the database.
    firebase::database::DatabaseReference dbref = database->GetReference();

Verileri bir kez oku

Belirli bir yoldaki içeriğin statik anlık görüntüsünü bir kez okumak için GetValue() yöntemini kullanabilirsiniz. Görev sonucu, alt veriler de dahil olmak üzere o konumdaki tüm verileri içeren bir anlık görüntü içerecektir. Veri yoksa döndürülen anlık görüntü null olur.

  firebase::Future<firebase::database::DataSnapshot> result =
    dbRef.GetReference("Leaders").GetValue();

Talebin yapıldığı noktada ancak değeri okuyabilmek için Future'ın tamamlanmasını beklememiz gerekiyor. Oyunlar genellikle bir döngüde çalıştığından ve diğer uygulamalara göre daha az geri arama odaklı olduğundan, genellikle tamamlama için yoklama yaparsınız.

  // In the game loop that polls for the result...

  if (result.status() != firebase::kFutureStatusPending) {
    if (result.status() != firebase::kFutureStatusComplete) {
      LogMessage("ERROR: GetValue() returned an invalid result.");
      // Handle the error...
    } else if (result.error() != firebase::database::kErrorNone) {
      LogMessage("ERROR: GetValue() returned error %d: %s", result.error(),
                 result.error_message());
      // Handle the error...
    } else {
      firebase::database::DataSnapshot snapshot = result.result();
      // Do something with the snapshot...
    }
  }

Bu, bazı temel hata denetimlerini gösterir, hata denetimi hakkında daha fazla bilgi ve sonucun ne zaman hazır olduğunu belirleme yolları için firebase::Future referansına bakın.

olayları dinle

Verilerdeki değişikliklere abone olmak için dinleyiciler ekleyebilirsiniz:

ValueListener temel sınıfı

Geri çağırmak	tipik kullanım
OnValueChanged	Bir yolun tüm içeriğindeki değişiklikleri okuyun ve dinleyin.

OnChildListener temel sınıfı

OnChildAdded	Öğe listelerini alın veya bir öğe listesine yapılan eklemeleri dinleyin. Listelerdeki değişiklikleri izlemek için OnChildChanged ve OnChildRemoved ile önerilen kullanım.
OnChildChanged	Listedeki öğelerde yapılan değişiklikleri dinleyin. Listelerdeki değişiklikleri izlemek için OnChildAdded ve OnChildRemoved ile kullanın.
OnChildRemoved	Listeden kaldırılan öğeleri dinleyin. Listelerdeki değişiklikleri izlemek için OnChildAdded ve OnChildChanged ile kullanın.
OnChildMoved	Sıralı bir listedeki öğelerin sırasındaki değişiklikleri dinleyin. OnChildMoved geri aramaları, öğenin sıra değişikliği nedeniyle (geçerli sipariş yönteminize göre) her zaman OnChildChanged geri aramalarını takip eder.

ValueListener sınıfı

Belirli bir yoldaki içerik değişikliklerine abone olmak için OnValueChanged geri aramalarını kullanabilirsiniz. Bu geri arama, dinleyici eklendiğinde bir kez ve çocuklar da dahil olmak üzere veriler her değiştiğinde tetiklenir. Geri arama, alt veriler de dahil olmak üzere o konumdaki tüm verileri içeren bir anlık görüntü iletilir. Veri yoksa döndürülen anlık görüntü null olur.

Önemli: OnValueChanged olayı, alt öğelerdeki değişiklikler de dahil olmak üzere, belirtilen veritabanı referansındaki veriler her değiştirildiğinde çağrılır. Anlık görüntülerinizin boyutunu sınırlamak için yalnızca değişiklikleri izlemek için gereken en yüksek düzeyde ekleyin. Örneğin, veritabanınızın kök dizinine bir dinleyici eklemeniz önerilmez.

Aşağıdaki örnek, veritabanından bir liderlik tablosunun puanlarını alan bir oyunu göstermektedir:

  class LeadersValueListener : public firebase::database::ValueListener {
   public:
    void OnValueChanged(
        const firebase::database::DataSnapshot& snapshot) override {
      // Do something with the data in snapshot...
    }
    void OnCancelled(const firebase::database::Error& error_code,
                     const char* error_message) override {
      LogMessage("ERROR: LeadersValueListener canceled: %d: %s", error_code,
                 error_message);
    }
  };

  // Elsewhere in the code...

  LeadersValueListener* listener = new LeadersValueListener();
  firebase::Future<firebase::database::DataSnapshot> result =
    dbRef.GetReference("Leaders").AddValueListener(listener);

Future&ltDataSnaphot&gt sonucu, olay anında veritabanında belirtilen konumdaki verileri içerir. Bir anlık görüntüde value() çağrısı, verileri temsil eden bir Variant döndürür.

Bu örnekte, okumanın iptal edilip edilmediğini görmek için OnCancelled yöntemi de geçersiz kılınır. Örneğin, istemcinin bir Firebase veritabanı konumundan okuma izni yoksa bir okuma iptal edilebilir. database::Error hatanın neden oluştuğunu gösterir.

ChildListener sınıfı

Alt olaylar, PushChild() yöntemi aracılığıyla eklenen yeni bir alt öğe veya UpdateChildren() yöntemi aracılığıyla güncellenen bir alt öğe gibi bir işlemden bir düğümün alt öğelerinin başına gelen belirli işlemlere yanıt olarak tetiklenir. Bunların her biri, bir veritabanındaki belirli bir düğümde yapılan değişiklikleri dinlemek için birlikte yararlı olabilir. Örneğin, bir oyun, aşağıda gösterildiği gibi, bir oyun oturumunun yorumlarındaki etkinliği izlemek için bu yöntemleri birlikte kullanabilir:

  class SessionCommentsChildListener : public firebase::database::ChildListener {
   public:
    void OnChildAdded(const firebase::database::DataSnapshot& snapshot,
                      const char* previous_sibling) override {
      // Do something with the data in snapshot ...
    }
    void OnChildChanged(const firebase::database::DataSnapshot& snapshot,
                        const char* previous_sibling) override {
      // Do something with the data in snapshot ...
    }
    void OnChildRemoved(
        const firebase::database::DataSnapshot& snapshot) override {
      // Do something with the data in snapshot ...
    }
    void OnChildMoved(const firebase::database::DataSnapshot& snapshot,
                      const char* previous_sibling) override {
      // Do something with the data in snapshot ...
    }
    void OnCancelled(const firebase::database::Error& error_code,
                     const char* error_message) override {
      LogMessage("ERROR: SessionCommentsChildListener canceled: %d: %s",
                 error_code, error_message);
    }
  };

  // elsewhere ....

  SessionCommentsChildListener* listener = new SessionCommentsChildListener();
  firebase::Future<firebase::database::DataSnapshot> result =
    dbRef.GetReference("GameSessionComments").AddChildListener(listener);

OnChildAdded geri araması, genellikle bir Firebase veritabanındaki öğelerin listesini almak için kullanılır. OnChildAdded geri araması, var olan her çocuk için bir kez ve belirtilen yola her yeni çocuk eklendiğinde tekrar çağrılır. Dinleyiciye, yeni çocuğun verilerini içeren bir anlık görüntü iletilir.

OnChildChanged geri araması, bir alt düğüm değiştirildiğinde her zaman çağrılır. Bu, alt düğümün alt öğelerinde yapılan tüm değişiklikleri içerir. Bir öğe listesindeki değişikliklere yanıt vermek için genellikle OnChildAdded ve OnChildRemoved çağrılarıyla birlikte kullanılır. Dinleyiciye iletilen anlık görüntü, alt öğe için güncellenmiş verileri içerir.

OnChildRemoved geri araması, acil bir alt öğe kaldırıldığında tetiklenir. Genellikle OnChildAdded ve OnChildChanged geri aramalarıyla birlikte kullanılır. Geri aramaya iletilen anlık görüntü, kaldırılan alt öğenin verilerini içerir.

OnChildMoved geri araması, çocuğun yeniden sıralanmasına neden olan bir güncelleştirme tarafından OnChildChanged çağrısı başlatıldığında tetiklenir. OrderByChild veya OrderByValue ile sıralanan verilerle kullanılır.

Verileri sıralama ve filtreleme

Anahtara, değere veya bir alt öğenin değerine göre sıralanmış verileri almak için Gerçek Zamanlı Veritabanı Query sınıfını kullanabilirsiniz. Ayrıca, sıralanan sonucu belirli sayıda sonuca veya bir anahtar veya değer aralığına göre filtreleyebilirsiniz.

Not: Filtreleme ve sıralama, özellikle istemcide yapıldığında pahalı olabilir. Uygulamanız sorgu kullanıyorsa, bu anahtarları sunucuda dizine eklemek ve Verilerinizi Dizine Ekleme bölümünde açıklandığı gibi sorgu performansını iyileştirmek için .indexOn kuralını tanımlayın.

Verileri sırala

Sıralanmış verileri almak için, sonuçların nasıl sıralanacağını belirlemek için sıralama yöntemlerinden birini belirleyerek başlayın:

Yöntem	Kullanım
OrderByChild()	Sonuçları belirtilen alt anahtarın değerine göre sıralayın.
OrderByKey()	Sonuçları alt anahtarlara göre sıralayın.
OrderByValue()	Sonuçları alt değerlere göre sıralayın.

Aynı anda yalnızca bir sıralama yöntemi kullanabilirsiniz. Aynı sorguda bir order-by yöntemini birden çok kez çağırmak hata verir.

Aşağıdaki örnek, puana göre sıralanmış bir puan skor tablosuna nasıl abone olabileceğinizi gösterir.

  firebase::database::Query query =
    dbRef.GetReference("Leaders").OrderByChild("score");

  // To get the resulting DataSnapshot either use query.GetValue() and poll the
  // future, or use query.AddValueListener() and register to handle the
  // OnValueChanged callback.

Bu, bir ValueListener ile birleştirildiğinde müşteriyi her girişin puanına göre sıralanmış şekilde veritabanındaki skor tablosuyla senkronize eden bir firebase::Query tanımlar. Verilerinizi verimli bir şekilde yapılandırma hakkında daha fazla bilgiyi Veritabanınızı Yapılandırın bölümünde bulabilirsiniz.

OrderByChild() yöntemine yapılan çağrı, sonuçların sıralanacağı alt anahtarı belirtir. Bu durumda, sonuçlar her çocuktaki "score" değerine göre sıralanır. Diğer veri türlerinin nasıl sıralandığı hakkında daha fazla bilgi için bkz . Sorgu verileri nasıl sıralanır .

Verileri filtreleme

Verileri filtrelemek için, bir sorgu oluştururken sınır veya aralık yöntemlerinden herhangi birini bir sıralama yöntemiyle birleştirebilirsiniz.

Yöntem	Kullanım
LimitToFirst()	Sıralı sonuç listesinin başından itibaren döndürülecek maksimum öğe sayısını ayarlar.
LimitToLast()	Sıralı sonuç listesinin sonundan döndürülecek maksimum öğe sayısını ayarlar.
StartAt()	Seçilen sıralama yöntemine bağlı olarak, belirtilen anahtar veya değerden büyük veya ona eşit öğeleri döndürün.
EndAt()	Seçilen sıralama yöntemine bağlı olarak, belirtilen anahtar veya değerden küçük veya ona eşit öğeler döndürün.
EqualTo()	Seçilen sıralama yöntemine bağlı olarak, belirtilen anahtara veya değere eşit öğeler döndürür.

Sıralama yöntemlerinin aksine, birden çok limit veya aralık işlevini birleştirebilirsiniz. Örneğin, sonuçları belirli bir değer aralığıyla sınırlamak için StartAt() ve EndAt() yöntemlerini birleştirebilirsiniz.

Sorgu için yalnızca tek bir eşleşme olduğunda bile, anlık görüntü yine de bir listedir; sadece tek bir öğe içerir.

Sonuç sayısını sınırla

Belirli bir geri arama için eşitlenecek maksimum çocuk sayısını ayarlamak için LimitToFirst() ve LimitToLast() yöntemlerini kullanabilirsiniz. Örneğin, 100'lük bir sınır ayarlamak için LimitToFirst() kullanırsanız, başlangıçta en fazla 100 OnChildAdded geri arama alırsınız. Firebase veritabanınızda depolanan 100'den az öğeniz varsa, her öğe için bir OnChildAdded geri araması tetiklenir.

Öğeler değiştikçe, sorguya giren öğeler için OnChildAdded geri aramaları ve sorgudan çıkan öğeler için OnChildRemoved geri aramaları alırsınız, böylece toplam sayı 100'de kalır.

Örneğin, aşağıdaki kod bir liderlik tablosundaki en yüksek puanı verir:

  firebase::database::Query query =
    dbRef.GetReference("Leaders").OrderByChild("score").LimitToLast(1);

  // To get the resulting DataSnapshot either use query.GetValue() and poll the
  // future, or use query.AddValueListener() and register to handle the
  // OnValueChanged callback.

Anahtar veya değere göre filtreleme

Sorgular için rasgele başlangıç, bitiş ve denklik noktaları seçmek için StartAt() , EndAt() ve EqualTo() öğelerini kullanabilirsiniz. Bu, verileri sayfalandırmak veya belirli bir değere sahip alt öğelerin bulunduğu öğeleri bulmak için yararlı olabilir.

Sorgu verileri nasıl sıralanır?

Bu bölümde, verilerin Query sınıfındaki sıralama yöntemlerinin her birine göre nasıl sıralandığı açıklanmaktadır.

OrderByChild

OrderByChild() kullanılırken, belirtilen alt anahtarı içeren veriler şu şekilde sıralanır:

1. Belirtilen alt anahtar için null değere sahip çocuklar önce gelir.
2. Ardından, belirtilen alt anahtar için false değerine sahip alt öğeler gelir. Birden fazla alt öğe false değerine sahipse, bunlar sözlüksel olarak anahtara göre sıralanır.
3. Ardından, belirtilen alt anahtar için true değerine sahip alt öğeler gelir. Birden fazla alt öğe true değerine sahipse, bunlar sözlüksel olarak anahtara göre sıralanır.
4. Sayısal değeri olan çocuklar, artan düzende sıralanır. Birden çok alt öğe, belirtilen alt düğüm için aynı sayısal değere sahipse, bunlar anahtara göre sıralanır.
5. Dizeler sayılardan sonra gelir ve sözlüksel olarak artan düzende sıralanır. Birden çok alt öğe, belirtilen alt düğüm için aynı değere sahipse, anahtara göre sözlüksel olarak sıralanır.
6. Nesneler en son gelir ve artan düzende anahtara göre sözlüksel olarak sıralanır.

OrderByKey

Verilerinizi sıralamak için OrderByKey() kullanıldığında, veriler anahtara göre artan düzende döndürülür.

1. 32 bitlik bir tamsayı olarak ayrıştırılabilen bir anahtarı olan alt öğeler, artan düzende sıralanarak önce gelir.
2. Sırada anahtarları dize değeri olan çocuklar gelir ve sözlüksel olarak artan düzende sıralanır.

OrderByValue

OrderByValue() kullanılırken, çocuklar değerlerine göre sıralanır. Sıralama ölçütleri, belirtilen alt anahtarın değeri yerine düğümün değerinin kullanılması dışında OrderByChild() ile aynıdır.

Sonraki adımlar

• Verileri Kaydetme