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 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 đề cập trong hướng dẫn Get Started
.
Lấy 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 tài liệu tham khảo 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ì trò chơi thường chạy theo vòng lặp và ít được điều khiển gọi lại hơn các ứng dụng khác nên bạn thường sẽ thăm dò để 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... } }
Phần này hiển thị một số cách 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ề việc kiểm tra lỗi và cách xác định khi nào kết quả đã sẵn sàng.
Lắng nghe 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 | Cách 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 đường dẫn. |
Lớp cơ sở OnChildListener
OnChildAdded | Truy xuất danh sách các mục hoặc lắng nghe phần bổ sung vào danh sách các mục. Đề xuất sử dụng với OnChildChanged và OnChildRemoved để 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 OnChildAdded và OnChildRemoved để 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 OnChildAdded và OnChildChanged để 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ự. Lệnh gọi lại OnChildMoved luôn tuân theo lệnh gọi lại OnChildChanged do thứ tự của mục 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ý các thay đổi đối vớ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à lặp lại mỗi khi dữ liệu, bao gồm cả dữ liệu con, thay đổi. Cuộc gọi lại được chuyển 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 lấy điểm 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<firebase::database::DataSnapshot> result = dbRef.GetReference("Leaders").AddValueListener(listener);
Kết quả Future<DataSnapshot>
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ề một Variant
đại diện cho dữ liệu.
Trong ví dụ này, phương thức OnCancelled
cũng bị ghi đè để xem liệu quá trình đọc có bị hủy hay không. Ví dụ: quá trình đọc có thể bị hủy nếu khách hàng không có quyền đọc từ vị trí 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 hoạt động cụ thể xảy ra với các nút con của một nút từ một thao tác, chẳng hạn như một nút con mới được thêm thông qua phương thức PushChild()
hoặc một nút con được cập nhật thông qua phương thức UpdateChildren()
. Mỗi thứ này kết hợp với nhau có thể hữu ích cho việc lắng nghe những 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);
Lệnh 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. 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ó và sau đó gọi lại mỗi lần có một thành phần con mới được thêm vào đường dẫn đã chỉ định. Người nghe được chuyển một ảnh chụp nhanh chứa dữ liệu của đứa trẻ mới.
Lệnh gọi lại OnChildChanged
được gọi bất cứ khi nào nút con được sửa đổi. Điều này bao gồm mọi sửa đổi đối với nút con của nút con. Nó thường được sử dụng cùng 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 chuyển đến người nghe chứa dữ liệu cập nhật cho trẻ.
Lệnh gọi lại OnChildRemoved
được kích hoạt khi một phần tử con ngay lập tức bị xóa. Nó thường được sử dụng cùng với các lệnh gọi lại OnChildAdded
và OnChildChanged
. Ảnh chụp nhanh được chuyển đến lệnh gọi lại chứa dữ liệu cho thành phần con đã bị xóa.
Lệnh gọi lại OnChildMoved
được kích hoạt bất cứ khi nào lệnh gọi OnChildChanged
được thực hiện bởi một bản cập nhật khiến trẻ sắp xếp lại thứ tự. Nó được sử dụng với dữ liệu được sắp xếp theo OrderByChild
hoặc OrderByValue
.
Sắp xếp và lọc dữ liệu
Bạn có thể sử dụng lớp Query
cơ sở dữ liệu thời gian thực để truy xuất dữ liệu được sắp xếp theo khóa, theo giá trị hoặc theo giá trị của phần tử 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 phạm vi khóa hoặc giá trị.
Sắp xếp dữ liệu
Để truy xuất dữ liệu đã được sắp xếp, hãy bắt đầu bằng cách chỉ định một trong các phương phá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() | Sắp xếp kết quả theo khóa con. |
OrderByValue() | Sắp xếp kết quả theo giá trị con. |
Bạn chỉ có thể sử dụng một phương pháp theo thứ tự tại một thời điểm. Việc 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 đây 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 một firebase::Query
mà khi kết hợp với ValueListener sẽ đồng bộ hóa ứng dụng khách với bảng xếp hạng trong cơ sở dữ liệu, được sắp xếp theo điểm của mỗi mục nhập. Bạn có thể đọc thêm về cách 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, kết quả được sắp xếp theo giá trị của giá trị "score"
ở mỗi trẻ. Để 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 thứ tự 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 theo thứ tự khi xây dựng truy vấn.
Phương pháp | Cách sử dụng |
---|---|
LimitToFirst() | Đặt số lượng mục tối đa cần 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 cần 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ị được chỉ định tùy thuộc vào phương pháp theo thứ tự đã chọn. |
EndAt() | Trả về các mục nhỏ hơn hoặc bằng khóa hoặc giá trị được chỉ định tùy thuộc vào phương pháp theo thứ tự đã chọn. |
EqualTo() | Trả về các mục bằng khóa hoặc giá trị được chỉ định tùy thuộc vào phương thức theo thứ tự đã chọn. |
Không giống như các phương phá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 thức StartAt()
và EndAt()
để giới hạn kết quả ở một phạm vi giá trị được chỉ định.
Ngay cả khi chỉ có một kết quả khớ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 thức LimitToFirst()
và LimitToLast()
để đặt số lượng con tối đa được đồng bộ hóa 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 của mình 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 truy vấn và lệnh gọi lại OnChildRemoved
cho các mục bị loại bỏ để tổng số vẫn ở mức 100.
Ví dụ: mã bên dưới trả về điểm 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()
và EqualTo()
để chọn điểm bắt đầu, kết thúc và điểm tương đương tùy ý cho 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ó trẻ em 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 sắp xếp dữ liệu theo từng phương pháp theo thứ tự trong lớp Query
.
OrderByChild
Khi sử dụng OrderByChild()
, dữ liệu chứa khóa con được chỉ định sẽ được sắp xếp như sau:
- Con có giá trị
null
cho khóa con được chỉ định sẽ được ưu tiên trước. - Tiếp theo là các phần tử con có giá trị
false
cho khóa con được chỉ định. 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. - Tiếp theo là các trẻ em 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 sẽ được sắp xếp theo từ điển theo khóa. - Tiếp theo là những phần tử có giá trị số, đượ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 được chỉ định thì chúng sẽ được sắp xếp theo khóa.
- Các chuỗi đứng sau các số và được sắp xếp theo thứ tự từ điển tăng dần. Nếu nhiều nút 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 khóa.
- Các đối tượng ở cuối cùng và được sắp xếp theo từ điển 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 sẽ được trả về theo thứ tự tăng dần theo khóa.
- Trẻ em có khóa có thể được phân tích cú pháp dưới dạng số nguyên 32 bit sẽ được xếp trước, được sắp xếp theo thứ tự tăng dần.
- Những phần tử con có giá trị chuỗi làm khóa sẽ xuất hiện 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()
, các phần tử con đượ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 cho giá trị của khóa con được chỉ định.