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

Tài liệu này trình bày những kiến thức cơ bản về cách 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

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

Truy xuất dữ liệu

Dữ liệu Firebase được truy xuất bằng cách gọi GetValue() một lần 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à gọi lại bất cứ khi nào dữ liệu thay đổi.

Lấy DatabaseReference

Để ghi dữ liệu vào Cơ sở dữ liệu, bạn cần có một thực thể 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ả của tác vụ sẽ chứa 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ề sẽ là null.

  firebase::Future&ltfirebase::database::DataSnapshot&gt 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 Future hoàn tất thì mới có thể đọc giá trị. Vì trò chơi thường chạy trong một vòng lặp và ít dựa trên lệnh gọi lại hơn các ứng dụng khác, nên bạn thường xuyên thăm dò để biết trạng thái hoàn tất.

  // 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ố bước kiểm tra lỗi cơ bản. Hãy xem tài liệu tham khảo firebase::Future để biết thêm thông tin về cách kiểm tra lỗi và cách xác định thời điểm kết quả sẵn sàng.

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

Bạn có thể thêm trình nghe để đăng ký các thay đổi đối với dữ liệu:

Lớp cơ sở ValueListener

Lớp cơ sở OnChildListener

Lớp ValueListener

Bạn có thể sử dụng lệnh gọi lại OnValueChanged để đăng ký các thay đổi đối với nội dung tại một đường dẫn nhất định. Lệnh gọi lại này được kích hoạt một lần khi trình nghe được đính kèm và kích hoạt lại mỗi khi dữ liệu (bao gồm cả dữ liệu con) thay đổi. Lệnh gọi lại được truyền 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ề sẽ là null.

Ví dụ sau đây minh hoạ một trò chơi truy xuất điểm số của bảng xếp hạng 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&ltfirebase::database::DataSnapshot&gt result =
    dbRef.GetReference("Leaders").AddValueListener(listener);

Kết quả Future&ltDataSnapshot&gt chứa dữ liệu tại vị trí được chỉ định trong cơ sở dữ liệu tại thời điểm xảy ra sự kiện. Việc gọi value() trên ảnh chụp nhanh sẽ 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 thao tác đọc có bị huỷ hay không. Ví dụ: thao tác đọc có thể bị huỷ nếu ứng dụng không có quyền đọc từ một vị trí trong cơ sở dữ liệu Firebase. 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 để phản hồi các thao tác cụ thể xảy ra với các thành phần con của một nút từ một thao tác, chẳng hạn như một thành phần con mới được thêm thông qua phương thức PushChild() hoặc một thành phần con được cập nhật thông qua phương thức UpdateChildren(). Mỗi thao tác này có thể hữu ích cho việc 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 thức này cùng nhau để theo dõi hoạt động trong phần bình luận của một phiên trò chơi, như minh hoạ 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&ltfirebase::database::DataSnapshot&gt result =
    dbRef.GetReference("GameSessionComments").AddChildListener(listener);

Lệnh gọi lại OnChildAdded thường được dùng để truy xuất danh sách các mục trong cơ sở dữ liệu Firebase. Lệnh gọi lại OnChildAdded được gọi một lần cho mỗi thành phần con hiện có, sau đó gọi lại mỗi khi một thành phần con mới được thêm vào đường dẫn được chỉ định. Trình nghe được truyền một ảnh chụp nhanh chứa dữ liệu của thành phần con mới.

Lệnh 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 mọi sửa đổi đối với các thành phần con của nút con. Phương thức này thường được dùng kết hợp với các lệnh gọi OnChildAdded và OnChildRemoved để 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 đến trình nghe chứa dữ liệu đã cập nhật cho thành phần con.

Lệnh gọi lại OnChildRemoved được kích hoạt khi một thành phần con trực tiếp bị xoá. Phương thức này thường được dùng kết hợp với các lệnh gọi lại OnChildAdded và OnChildChanged. Ảnh chụp nhanh được truyền đến lệnh gọi lại chứa dữ liệu của thành phần con bị xoá.

Lệnh gọi lại OnChildMoved được kích hoạt bất cứ khi nào lệnh gọi OnChildChanged được đưa ra bởi một bản cập nhật khiến thành phần con được sắp xếp lại. Phương thức này được dùng với dữ liệu được sắp xếp bằng 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 để truy xuất dữ liệu được sắp xếp theo khoá, theo giá trị hoặc theo giá trị của một thành phần con. Bạn cũng có thể lọc kết quả đã sắp xếp theo một số kết quả cụ thể hoặc một dải khoá 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 thức sắp xếp theo thứ tự để xác định cách sắp xếp kết quả:

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

Ví dụ sau đây minh hoạ 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 một firebase::Query mà khi kết hợp với một ValueListener sẽ đồng bộ hoá ứng dụng với bảng xếp hạng trong cơ sở dữ liệu, được sắp xếp theo điểm số của từng mục. Bạn có thể đọc thêm về cách cấu trúc dữ liệu một cách hiệu quả trong Cấu trúc cơ sở dữ liệu.

Lệnh gọi đến phương thức OrderByChild() chỉ định khoá con để sắp xếp kết quả theo thứ tự. Trong trường hợp này, kết quả được sắp xếp theo giá trị của "score" giá trị trong mỗi thành phần 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 thức giới hạn hoặc dải ô nào với phương thức sắp xếp theo thứ tự khi tạo truy vấn.

Không giống như các phương thức 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 dải ô. Ví dụ: bạn có thể kết hợp các phương thức StartAt() và EndAt() để giới hạn kết quả trong một dải giá trị được chỉ định.

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

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

Bạn có thể sử dụng các phương thức LimitToFirst() và LimitToLast() để đặt số lượng thành phần con tối đa cần đồng bộ hoá cho một lệnh gọi lại nhất định. Ví dụ: nếu bạn sử dụng LimitToFirst() để đặt giới hạn là 100, thì 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, thì lệnh gọi lại OnChildAdded sẽ kích hoạt cho từng mục.

Khi các mục thay đổi, bạn sẽ nhận được lệnh gọi lại OnChildAdded cho các mục nhập vào truy vấn và lệnh gọi lại OnChildRemoved cho các mục rời khỏi truy vấn để tổng số vẫn là 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 khoá hoặc giá trị

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

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

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

OrderByChild

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

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

OrderByKey

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

1. Các thành phần con có khoá có thể được phân tích cú pháp dưới dạng số nguyên 32 bit sẽ xuất hiện trước, được sắp xếp theo thứ tự tăng dần.
2. Các thành phần con có giá trị chuỗi làm khoá sẽ xuất hiện tiếp theo, được sắp xếp theo thứ tự từ điển theo thứ tự tăng dần.

OrderByValue

Khi sử dụng OrderByValue(), các thành phần con sẽ được sắp xếp theo giá trị của chúng. Các tiêu chí sắp xếp giống như trong OrderByChild(), ngoại trừ việc giá trị của nút được sử dụng thay vì giá trị của một khoá con được chỉ định.

Các bước tiếp theo

• Lưu dữ liệu