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

Lấy 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 có một thực thể của DatabaseReference:

DatabaseReference ref = FirebaseDatabase.instance.ref();

Lưu ý: Theo mặc định, quyền đọc và ghi vào cơ sở dữ liệu của bạn bị hạn chế, vì vậy, chỉ những người dùng đã xác thực mới có thể đọc hoặc ghi dữ liệu. Để bắt đầu mà không cần thiết lập tính năng Xác thực Firebase, bạn có thể định cấu hình quy tắc cho quyền truy cập công khai. Điều này khiến cơ sở dữ liệu của bạn mở cho bất cứ ai, kể cả những người không dùng ứng dụng của bạn. Vì vậy, hãy nhớ hạn chế cơ sở dữ liệu một lần nữa khi bạn thiết lập tính năng xác thực.

Đọc và ghi danh sách

Thêm 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 phần tử con vào cùng một vị trí cùng một lúc mà không xảy ra xung đột 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 sẽ tự động được sắp xếp theo thứ tự thời gian.

Bạn có thể sử dụng thông tin tham chiếu đến dữ liệu mới do phương thức push() trả về để lấy giá trị khoá do phần tử con tạo tự động hoặc tập dữ liệu cho phần tử con đó. Thuộc tính .key của tệp 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ề việc phân phối dữ liệu.

Ví dụ: bạn có thể 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 các sự kiện con

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 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 push() hoặc một nút con đang được cập nhật thông qua phương thức update().

Sự kiện	Cách sử dụng thông thường
onChildAdded	Truy xuất danh sách các mục hoặc nghe nội dung bổ sung vào danh sách các mục. Sự kiện này được kích hoạt một lần cho mỗi phần tử con hiện có, sau đó được kích hoạt lại mỗi khi một phần tử con mới được thêm vào đường dẫn đã chỉ định. Trình nghe được truyền một ảnh chụp nhanh chứa dữ liệu của phần tử con mới.
onChildChanged	Theo dõi những thay đổi đối với các mục trong danh sách. Sự kiện này được kích hoạt bất cứ khi nào một nút con được sửa đổi. Điều này bao gồm mọi nội dung sửa đổi đối với các phần tử con của nút con. Ảnh chụp nhanh được truyền đến trình nghe sự kiện chứa dữ liệu đã cập nhật cho phần tử con.
onChildRemoved	Theo dõi các mục bị xoá khỏi danh sách. Sự kiện này được kích hoạt khi một thành phần con cấp cao bị xoá. Ảnh chụp nhanh được truyền đến khối gọi lại chứa dữ liệu cho thành phần con đã xoá.
onChildMoved	Theo dõi các thay đổi đối với thứ tự của các mục trong danh sách đã sắp xếp. Các sự kiện onChildMoved luôn tuân theo sự kiện onChildChanged đã khiến 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).

Mỗi phương thức này có thể hữu ích khi 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 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ạ dưới đây:

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 con là cách được đề xuất để đọc danh sách dữ liệu, nhưng có những trường hợp việc theo dõi các sự kiện giá trị trên tệp 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. Sau đó, bạn có thể lặp lại để truy cập vào từng phần tử con.

Ngay cả khi chỉ có một kết quả phù hợp với truy vấn, ảnh chụp nhanh vẫn là một danh sách; chỉ chứa một mục duy nhất. Để truy cập vào mục này, 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ả phần tử 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êm phần tử con khác.

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 phần tử 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 khoá hoặc giá trị.

Lưu ý: Việc lọc và sắp xếp có thể tốn kém, đặc biệt là khi thực hiện trên máy khách. Nếu ứng dụng của bạn sử dụng truy vấn, hãy xác định quy tắc .indexOn để lập chỉ mục các khoá đó trên máy chủ và cải thiện hiệu suất truy vấn như mô tả trong phần Lập chỉ mục dữ liệu.

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ả:

Phương thức	Cách sử dụng
orderByChild()	Sắp xếp kết quả theo giá trị của khoá con đã chỉ định hoặc đường dẫn con lồng nhau.
orderByKey()	Sắp xếp kết quả theo khoá con.
orderByValue()	Sắp xếp kết quả theo giá trị con.

Mỗi lần, bạn chỉ có thể sử dụng một phương thức sắp xếp theo. Việc gọi phương thức sắp xếp theo 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ượng dấu sao:

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

Thao tác này xác định một truy vấn mà khi kết hợp với trình nghe 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ã nhận dạng người dùng, được sắp xếp theo số lượng sao 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 này được gọi là phân tán dữ liệu. Bạn có thể đọc thêm về kỹ thuật này trong phần Xây dựng 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ả. Trong trường hợp này, các bài đăng được sắp xếp theo giá trị của phần tử con "starCount" tương ứng. Bạn cũng có thể sắp xếp các truy vấn theo phần tử 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ử danh sách theo giá trị được lồng trong khoá metrics bằng cách chỉ định đường dẫn tương đối đến phần tử con được lồng 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 phần 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 một phương thức theo thứ tự khi tạo truy vấn.

Lưu ý: Bạn không nên sử dụng các ký tự Unicode đặc biệt trong khoá, chẳng hạn như \u{0000}. Hãy xem vấn đề về Flutter để biết thêm chi tiết.

Phương thức	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ả đã 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ả đã sắp xếp.
startAt()	Trả về các mục lớn hơn hoặc bằng khoá hoặc giá trị đã chỉ định, tuỳ thuộc vào phương thức sắp xếp theo thứ tự đã chọn.
startAfter()	Trả về các mục lớn hơn khoá hoặc giá trị đã chỉ định tuỳ thuộc vào phương thức sắp xếp theo thứ tự đã chọn.
endAt()	Trả về những mặt hàng có giá trị nhỏ hơn hoặc bằng khoá hoặc giá trị đã chỉ định, tuỳ thuộc vào thứ tự đã chọn của phương thức.
endBefore()	Trả về các mục nhỏ hơn khoá hoặc giá trị đã chỉ định tuỳ thuộc vào phương thức sắp xếp theo thứ tự đã chọn.
equalTo()	Trả về các mục bằng với khoá hoặc giá trị đã chỉ định, tuỳ thuộc vào phương thức sắp xếp theo thứ tự đã chọn.

Không giống như các phương thức sắp xếp theo, bạn có thể kết hợp nhiều hàm giới hạn hoặc hàm 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ụ thể.

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 tối đa phần tử con cần đồng bộ hoá cho một sự kiện nhất định. Ví dụ: nếu sử dụng limitToFirst() để đặt giới hạn là 100, ban đầu, bạn sẽ 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ì một 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 sự kiện onChildAdded cho các mục nhập vào truy vấn và sự kiện onChildRemoved cho các mục bị loại bỏ khỏi truy vấn để tổng số mục vẫn giữ nguyên ở mức 100.

Ví dụ sau đây minh hoạ cách ứng dụng viết 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, cần có một trình nghe đí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 điểm bắt đầu, kết thúc và điểm tương đương 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ó phần tử 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á con đã chỉ định sẽ được sắp xếp như sau:

1. Các phần tử con có giá trị null cho khoá con đã chỉ định sẽ xuất hiện trước.
2. Tiếp theo là các phần tử con có giá trị false cho khoá con đã chỉ định. Nếu nhiều phần tử con có giá trị là false, thì các phần tử con đó sẽ được sắp xếp theo thứ tự bảng chữ cái theo khoá.
3. Tiếp theo là các phần tử con có giá trị true cho khoá con đã chỉ định. Nếu nhiều phần tử con có giá trị là true, thì các phần tử con đó sẽ được sắp xếp theo thứ tự bảng chữ cái theo khoá.
4. Tiếp theo là các phần tử con 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 một giá trị số cho nút con được chỉ định, thì các nút con đó sẽ được sắp xếp theo khoá.
5. Chuỗi đứng sau số và được sắp xếp theo thứ tự bảng chữ cái theo thứ tự tăng dần. Nếu nhiều nút con có cùng một giá trị cho nút con được chỉ định, thì các nút con đó sẽ được sắp xếp theo thứ tự bảng chữ cái 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ự bảng chữ cái 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 phần tử 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 tiên, được sắp xếp theo thứ tự tăng dần.
2. Tiếp theo là các phần tử con có giá trị chuỗi làm khoá, được sắp xếp theo thứ tự bảng chữ cái 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. 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 khoá con được chỉ định.

Tách trình nghe

Bạn có thể xoá lệnh gọi lại 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 đó dưới dạng tham số đến off(). Việc gọi off() trên vị trí không có đối số sẽ xoá tất cả trình nghe tại vị trí đó.

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

Các bước tiếp theo

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