Làm việc với Danh sách dữ liệu

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

Để đọc hoặc ghi dữ liệu từ cơ sở dữ liệu, bạn cần một thực thể của DatabaseReference:

DatabaseReference ref = FirebaseDatabase.instance.ref();

Đọc và ghi danh sách

Nối vào danh sách dữ liệu

Sử dụng phương thức push() để nối dữ liệu vào danh sách trong các ứng dụng nhiều người dùng. Phương thức push() tạo một khoá duy nhất mỗi khi một thành phần con mới được thêm vào tham chiếu Firebase đã chỉ định. Bằng cách sử dụng các khoá được tạo tự động này cho mỗi phần tử mới trong danh sách, một số ứng dụng có thể thêm thành phần con vào cùng một vị trí cùng một lúc mà không bị xung đột khi ghi. Khoá duy nhất do push() tạo dựa trên dấu thời gian, vì vậy, các mục trong danh sách được tự động sắp xếp theo trình tự thời gian.

Bạn có thể sử dụng tham chiếu đến dữ liệu mới do phương thức push() trả về để lấy giá trị của khoá được tạo tự động của thành phần con hoặc đặt dữ liệu cho thành phần con. Thuộc tính .key của tham chiếu push() chứa khoá được tạo tự động.

Bạn có thể sử dụng các khoá được tạo tự động này để đơn giản hoá việc làm phẳng cấu trúc dữ liệu. Để biết thêm thông tin, hãy xem ví dụ về phân đầu ra dữ liệu.

Ví dụ: bạn có thể sử dụng push() để thêm bài đăng mới vào danh sách bài đăng trong một ứng dụng mạng xã hội:

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

Theo dõi sự kiện thành phần con

Các sự kiện thành phầ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 push() hoặc một thành phần con đang được cập nhật thông qua phương thức update().

Mỗi sự kiện này có thể hữu ích cho việc theo dõi các thay đổi đối với một nút cụ thể trong cơ sở dữ liệu. Ví dụ: một ứng dụng blog mạng xã hộ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 bài đăng, như minh hoạ bên dưới:

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

Theo dõi sự kiện giá trị

Mặc dù việc theo dõi các sự kiện thành phần con là cách được đề xuất để đọc danh sách dữ liệu, nhưng trong một số trường hợp, việc theo dõi các sự kiện giá trị trên tham chiếu danh sách sẽ hữu ích.

Việc đính kèm trình nghe value vào danh sách dữ liệu sẽ trả về toàn bộ danh sách dữ liệu dưới dạng một ảnh chụp nhanh duy nhất mà sau đó bạn có thể lặp lại để truy cập vào từng thành phần con.

Ngay cả khi chỉ có một kết quả phù hợp cho truy vấn, ảnh chụp nhanh vẫn là một danh sách; ảnh chụp nhanh chỉ chứa một mục. Để truy cập vào mục đó, bạn cần lặp lại kết quả:

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

Mẫu này có thể hữu ích khi bạn muốn tìm nạp tất cả các thành phần con của một danh sách trong một thao tác duy nhất, thay vì theo dõi các sự kiện thành phần con được thêm vào.

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

Bạn có thể sử dụng lớp 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 thành một số kết quả cụ thể hoặc một phạm vi 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 để 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 tại một thời điểm. Việc gọi phương thức sắp xếp 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ể truy xuất danh sách các bài đăng hàng đầu của người dùng được sắp xếp theo số lượt thích:

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

Điều này xác định một truy vấn mà khi kết hợp với trình nghe thành phần con sẽ đồng bộ hoá ứng dụng với các bài đăng của người dùng từ đường dẫn trong cơ sở dữ liệu dựa trên mã người dùng của họ, được sắp xếp theo số lượt thích mà mỗi bài đăng nhận được. Kỹ thuật sử dụng mã nhận dạng làm khoá chỉ mục được gọi là phân đầu ra dữ liệu. Bạn có thể đọc thêm về kỹ thuật này trong Cấu trúc cơ sở dữ liệu.

Lệnh gọi đến phương thức orderByChild() chỉ định khoá thành phần con để sắp xếp kết quả. Trong trường hợp này, các bài đăng được sắp xếp theo giá trị của thành phần con "starCount" tương ứng. Bạn cũng có thể sắp xếp các truy vấn theo thành phần con lồng nhau, trong trường hợp bạn có dữ liệu như sau:

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

Trong trường hợp này, chúng ta có thể sắp xếp các phần tử trong danh sách theo các giá trị được lồng bên dưới khoá metrics bằng cách chỉ định đường dẫn tương đối đến thành phần con lồng nhau trong lệnh gọi orderByChild().

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

Để 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 phạm vi nào với phương thức sắp xếp khi tạo truy vấn.

Không giống như các phương thức sắp xếp, 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ả trong một phạm vi giá trị được chỉ định.

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 sự kiện 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 sự kiện onChildAdded. Nếu bạn có ít hơn 100 mục được lưu trữ trong cơ sở dữ liệu Firebase, thì sự kiện onChildAdded sẽ kích hoạt cho mỗi mục.

Khi các mục thay đổi, bạn sẽ nhận được các sự kiện onChildAdded cho các mục nhập truy vấn và các sự kiện onChildRemoved cho các mục bị loại khỏi truy vấn để tổng số vẫn là 100.

Ví dụ sau đây minh hoạ cách ứng dụng blog mẫu xác định một truy vấn để truy xuất danh sách 100 bài đăng gần đây nhất của tất cả người dùng:

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

Ví dụ này chỉ xác định một truy vấn. Để thực sự đồng bộ hoá dữ liệu, truy vấn cần có một trình nghe được đính kèm .

Lọc theo khoá hoặc giá trị

Bạn có thể sử dụng startAt(), startAfter(),endAt(), endBefore() 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 trong lớp Query.

orderByChild

Khi sử dụng orderByChild(), dữ liệu chứa khoá thành phần 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á thành phần con được chỉ định sẽ xuất hiện đầu tiên.
2. Các thành phần con có giá trị false cho khoá thành phần con được chỉ định 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á thành phần 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 thành phần 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 tăng dần. Nếu nhiều thành phần con có cùng giá trị cho nút thành phần 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 cuối 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 đầu tiên, đượ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 tăng dần.

orderByValue

Khi sử dụng orderByValue(), các thành phần con được sắp xếp theo giá trị của chúng. 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 khoá thành phần con được chỉ định.

Tách trình nghe

Các lệnh gọi lại được xoá bằng cách gọi phương thức off() trên tham chiếu cơ sở dữ liệu Firebase.

Bạn có thể xoá một trình nghe bằng cách truyền trình nghe đó làm tham số cho off(). Việc gọi off() trên vị trí mà không có đối số sẽ xoá tất cả các trình nghe tại vị trí đó.

Việc gọi off() trên trình nghe mẹ không tự động xoá các trình nghe đã đăng ký trên các nút thành phần con của nó; bạn cũng phải gọi off() trên mọi trình nghe thành phần con để xoá lệnh gọi lại.

Các bước tiếp theo

• Tìm hiểu cách cấu trúc dữ liệu
• Lưu trữ dữ liệu khi không có mạng