Truy xuất dữ liệu với Cơ sở dữ liệu thời gian thực của Firebase cho C ++

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tài liệu này trình bày những kiến ​​thức cơ bản về truy xuất dữ liệu cũng như cách sắp xếp và lọc dữ liệu Firebase.

Trước khi bắt đầu

Đảm bảo rằng bạn đã thiết lập ứng dụng của mình và có thể truy cập cơ sở dữ liệu như được trình bày trong hướng dẫn Get Started .

Truy xuất dữ liệu

Dữ liệu Firebase được truy xuất bằng lệnh gọi một lần tới GetValue() hoặc đính kèm vào ValueListener trên tham chiếu FirebaseDatabase . Trình nghe giá trị được gọi một lần cho trạng thái ban đầu của dữ liệu và một lần nữa bất cứ khi nào dữ liệu thay đổi.

Nhận một tham chiếu cơ sở dữ liệu

Để ghi dữ liệu vào Cơ sở dữ liệu, bạn cần một phiên bản của DatabaseReference :

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

Đọc dữ liệu một lần

Bạn có thể sử dụng phương thức GetValue() để đọc ảnh chụp nhanh tĩnh của nội dung tại một đường dẫn nhất định một lần. Kết quả tác vụ sẽ chứa ảnh chụp nhanh chứa tất cả dữ liệu tại vị trí đó, bao gồm cả dữ liệu con. Nếu không có dữ liệu, ảnh chụp nhanh được trả về là null .

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

Tại thời điểm yêu cầu đã được thực hiện nhưng chúng ta phải đợi Tương lai hoàn thành trước khi có thể đọc giá trị. Vì các trò chơi thường chạy theo vòng lặp và ít bị gọi lại hơn so với các ứng dụng khác, nên thông thường bạn sẽ thăm dò ý kiến ​​để hoàn thành.

  // 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...
    }
  }

Điều này cho thấy một số kiểm tra lỗi cơ bản, hãy xem tham chiếu firebase::Future để biết thêm thông tin về kiểm tra lỗi và cách xác định khi nào kết quả sẵn sàng.

Lắng nghe các sự kiện

Bạn có thể thêm người nghe để đăng ký thay đổi dữ liệu:

Lớp cơ sở ValueListener

Gọi lại sử dụng điển hình
OnValueChanged Đọc và lắng nghe những thay đổi đối với toàn bộ nội dung của một đường dẫn.

Lớp cơ sở OnChildListener

OnChildAdded Truy xuất danh sách các mục hoặc lắng nghe các bổ sung cho danh sách các mục. Đề xuất sử dụng với OnChildChangedOnChildRemoved để theo dõi các thay đổi đối với danh sách.
OnChildChanged Lắng nghe những thay đổi đối với các mục trong danh sách. Sử dụng với OnChildAddedOnChildRemoved để theo dõi các thay đổi đối với danh sách.
OnChildRemoved Lắng nghe các mục bị xóa khỏi danh sách. Sử dụng với OnChildAddedOnChildChanged để theo dõi các thay đổi đối với danh sách.
OnChildMoved Lắng nghe những thay đổi về thứ tự của các mục trong danh sách có thứ tự. Các lệnh gọi lại OnChildMoved luôn tuân theo các lệnh gọi lại OnChildChanged do thứ tự của mặt hàng thay đổi (dựa trên phương thức sắp xếp theo thứ tự hiện tại của bạn).

lớp ValueListener

Bạn có thể sử dụng lệnh gọi lại OnValueChanged để đăng ký thay đổi nội dung tại một đường dẫn nhất định. Cuộc gọi lại này được kích hoạt một lần khi người nghe được đính kèm và một lần nữa mỗi khi dữ liệu, bao gồm cả trẻ em, thay đổi. Cuộc gọi lại được thông qua một ảnh chụp nhanh chứa tất cả dữ liệu tại vị trí đó, bao gồm cả dữ liệu con. Nếu không có dữ liệu, ảnh chụp nhanh được trả về là null .

Ví dụ sau minh họa một trò chơi truy xuất điểm số của bảng thành tích từ cơ sở dữ liệu:

  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);

Kết quả Future&ltDataSnaphot&gt chứa dữ liệu tại vị trí đã chỉ định trong cơ sở dữ liệu tại thời điểm xảy ra sự kiện. value() trên ảnh chụp nhanh trả về Variant đại diện cho dữ liệu.

Trong ví dụ này, phương thức OnCancelled cũng bị ghi đè để xem việc đọc có bị hủy hay không. Ví dụ: một lần đọc có thể bị hủy nếu ứng dụng khách không có quyền đọc từ vị trí cơ sở dữ liệu Firebase. Cơ database::Error sẽ cho biết lý do xảy ra lỗi.

Lớp ChildListener

Các sự kiện con được kích hoạt để đáp ứng với các hoạt động cụ thể xảy ra với các nút con của một nút từ một hoạt động, chẳng hạn như một phần tử con mới được thêm vào thông qua phương thức PushChild() hoặc một phần tử con được cập nhật thông qua phương thức UpdateChildren() . Mỗi thứ này cùng nhau có thể hữu ích để lắng nghe các thay đổi đối với một nút cụ thể trong cơ sở dữ liệu. Ví dụ: một trò chơi có thể sử dụng các phương pháp này cùng nhau để theo dõi hoạt động trong phần nhận xét của phiên trò chơi, như minh họa bên dưới:

  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);

Gọi lại OnChildAdded thường được sử dụng để truy xuất danh sách các mục trong cơ sở dữ liệu Firebase. Cuộc gọi lại OnChildAdded được gọi một lần cho mỗi đứa trẻ hiện có và sau đó gọi lại mỗi khi một đứa trẻ mới được thêm vào đường dẫn đã chỉ định. Người nghe được chuyển một ảnh chụp nhanh có chứa dữ liệu của đứa trẻ mới.

Cuộc gọi lại OnChildChanged được gọi bất cứ khi nào một nút con được sửa đổi. Điều này bao gồm bất kỳ sửa đổi nào đối với hậu duệ của nút con. Nó thường được sử dụng cùng với các lệnh gọi OnChildAddedOnChildRemoved để phản hồi các thay đổi đối với danh sách các mục. Ảnh chụp nhanh được truyền cho người nghe chứa dữ liệu được cập nhật cho trẻ.

Cuộc gọi lại OnChildRemoved được kích hoạt khi một đứa trẻ ngay lập tức bị xóa. Nó thường được sử dụng cùng với các cuộc gọi lại OnChildAddedOnChildChanged . Ảnh chụp nhanh được chuyển đến cuộc gọi lại chứa dữ liệu cho phần tử con đã bị xóa.

Cuộc gọi lại OnChildMoved được kích hoạt bất cứ khi nào cuộc gọi OnChildChanged được đưa ra bởi một bản cập nhật gây ra sự sắp xếp lại thứ tự của đứa trẻ. Nó được sử dụng với dữ liệu được sắp xếp với OrderByChild hoặc OrderByValue .

Sắp xếp và lọc dữ liệu

Bạn có thể sử dụng lớp Realtime Database Query để lấy dữ liệu được sắp xếp theo khóa, theo giá trị hoặc theo giá trị con. Bạn cũng có thể lọc kết quả đã sắp xếp thành một số kết quả cụ thể hoặc một dải khóa hoặc giá trị.

Sắp xếp dữ liệu

Để truy xuất dữ liệu đã sắp xếp, hãy bắt đầu bằng cách chỉ định một trong các phương pháp sắp xếp theo thứ tự để xác định cách sắp xếp kết quả:

Phương pháp Cách sử dụng
OrderByChild() Sắp xếp kết quả theo giá trị của khóa con được chỉ định.
OrderByKey() Thứ tự kết quả theo các phím con.
OrderByValue() Sắp xếp thứ tự kết quả theo các giá trị con.

Bạn chỉ có thể sử dụng một phương thức đặt hàng tại một thời điểm. Gọi một phương thức theo thứ tự nhiều lần trong cùng một truy vấn sẽ gây ra lỗi.

Ví dụ sau minh họa cách bạn có thể đăng ký bảng xếp hạng điểm số được sắp xếp theo điểm số.

  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.

Điều này xác định firebase::Query mà khi được kết hợp với ValueListener sẽ đồng bộ hóa ứng dụng khách với bảng thành tích trong cơ sở dữ liệu, được sắp xếp theo điểm của từng mục nhập. Bạn có thể đọc thêm về cấu trúc dữ liệu của mình một cách hiệu quả trong Cấu trúc cơ sở dữ liệu của bạn .

Lệnh gọi phương thức OrderByChild() chỉ định khóa con để sắp xếp kết quả theo. Trong trường hợp này, các kết quả được sắp xếp theo giá trị của giá trị "score" ở mỗi phần tử con. Để biết thêm thông tin về cách sắp xếp các loại dữ liệu khác, hãy xem Cách sắp xếp dữ liệu truy vấn .

Lọc dữ liệu

Để lọc dữ liệu, bạn có thể kết hợp bất kỳ phương pháp giới hạn hoặc phạm vi nào với phương pháp sắp xếp theo thứ tự khi tạo truy vấn.

Phương pháp Cách sử dụng
LimitToFirst() Đặt số lượng mục tối đa để trả về từ đầu danh sách kết quả được sắp xếp.
LimitToLast() Đặt số lượng mục tối đa sẽ trả về từ cuối danh sách kết quả được sắp xếp.
StartAt() Trả về các mục lớn hơn hoặc bằng khóa hoặc giá trị đã chỉ định tùy thuộc vào phương thức đặt hàng đã chọn.
EndAt() Trả về các mục nhỏ hơn hoặc bằng khóa hoặc giá trị đã chỉ định tùy thuộc vào phương thức đặt hàng đã chọn.
EqualTo() Trả về các mục bằng với khóa hoặc giá trị đã chỉ định tùy thuộc vào phương thức đặt hàng đã chọn.

Không giống như các phương pháp sắp xếp theo thứ tự, bạn có thể kết hợp nhiều hàm giới hạn hoặc phạm vi. Ví dụ: bạn có thể kết hợp các phương StartAt()EndAt() để giới hạn kết quả trong một phạm vi giá trị đã chỉ định.

Ngay cả khi chỉ có một kết quả phù hợp duy nhất cho truy vấn, ảnh chụp nhanh vẫn là một danh sách; nó chỉ chứa một mục duy nhất.

Giới hạn số lượng kết quả

Bạn có thể sử dụng các phương LimitToFirst()LimitToLast() để đặt số lượng phần tử con tối đa được đồng bộ hóa cho một cuộc gọi lại nhất định. Ví dụ: nếu bạn sử dụng LimitToFirst() để đặt giới hạn là 100, ban đầu bạn chỉ nhận được tối đa 100 lệnh gọi lại OnChildAdded . Nếu bạn có ít hơn 100 mục được lưu trữ trong cơ sở dữ liệu Firebase của mình, lệnh gọi lại OnChildAdded kích hoạt cho từng mục.

Khi các mục thay đổi, bạn nhận được lệnh gọi lại OnChildAdded cho các mục nhập truy vấn và lệnh gọi lại OnChildRemoved cho các mục bị loại khỏi truy vấn để tổng số vẫn ở mức 100.

Ví dụ: mã bên dưới trả về điểm số cao nhất từ ​​​​bảng xếp hạng:

  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.

Lọc theo khóa hoặc giá trị

Bạn có thể sử dụng StartAt() , EndAt()EqualTo() để chọn các điểm bắt đầu, kết thúc và tương đương tùy ý cho các truy vấn. Điều này có thể hữu ích để phân trang dữ liệu hoặc tìm các mục có con có giá trị cụ thể.

Cách dữ liệu truy vấn được sắp xếp

Phần này giải thích cách dữ liệu được sắp xếp theo từng phương thức theo thứ tự trong lớp Query .

OrderByChild

Khi sử dụng OrderByChild() , dữ liệu chứa khóa con đã chỉ định được sắp xếp như sau:

  1. Con có giá trị null cho khóa con được chỉ định đến trước.
  2. Các phần tử con có giá trị false cho khóa con được chỉ định sẽ xuất hiện tiếp theo. Nếu nhiều phần tử con có giá trị false , chúng sẽ được sắp xếp theo từ điển theo khóa.
  3. Tiếp theo là các phần tử con có giá trị true cho khóa con được chỉ định. Nếu nhiều phần tử con có giá trị true , thì chúng được sắp xếp theo từ điển theo khóa.
  4. Trẻ em có giá trị số tiếp theo, được sắp xếp theo thứ tự tăng dần. Nếu nhiều nút con có cùng giá trị số cho nút con đã chỉ định, chúng sẽ được sắp xếp theo khóa.
  5. Các chuỗi đứng sau các số và được sắp xếp theo từ điển theo thứ tự tăng dần. Nếu nhiều nút con có cùng giá trị cho nút con đã chỉ định, chúng sẽ được sắp xếp theo thứ tự từ điển theo khóa.
  6. Các đối tượng đến cuối cùng và được sắp xếp theo từ điển theo khóa theo thứ tự tăng dần.

OrderByKey

Khi sử dụng OrderByKey() để sắp xếp dữ liệu của bạn, dữ liệu được trả về theo thứ tự tăng dần theo khóa.

  1. Phần tử con có khóa có thể được phân tích cú pháp dưới dạng số nguyên 32 bit sẽ đến trước, được sắp xếp theo thứ tự tăng dần.
  2. Trẻ em có giá trị chuỗi làm khóa tiếp theo, được sắp xếp theo từ điển theo thứ tự tăng dần.

OrderByValue

Khi sử dụng OrderByValue() , trẻ em được sắp xếp theo giá trị của chúng. Tiêu chí đặt hàng giống như trong OrderByChild() , ngoại trừ giá trị của nút được sử dụng thay vì giá trị của khóa con được chỉ định.

Bước tiếp theo