Làm việc với List of Data (Danh sách dữ liệu) trên các nền tảng của Apple

Nhận FIRDatabaseReference

Để đọc hoặc ghi dữ liệu vào cơ sở dữ liệu, bạn cần có một phiên bản của FIRDatabaseReference:

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

var ref: DatabaseReference!

ref = Database.database().reference()

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

@property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

Lưu ý: Theo mặc định, quyền đọc và ghi vào cơ sở dữ liệu của bạn sẽ bị hạn chế để 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 Authentication, bạn có thể định cấu hình các quy tắc để truy cập công khai. Điều này sẽ khiến cơ sở dữ liệu của bạn mở cho bất kỳ ai, ngay cả những người không sử dụng ứng dụng của bạn, vì vậy, hãy nhớ hạn chế cơ sở dữ liệu của bạn một lần nữa khi bạn thiết lập quy trình 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 childByAutoId để thêm dữ liệu vào danh sách trong các ứng dụng nhiều người dùng. Phương thức childByAutoId sẽ tạo một khoá duy nhất mỗi khi một phần tử 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 từng phần tử mới trong danh sách, nhiều ứng dụng có thể thêm các phần tử con vào cùng một vị trí cùng lúc mà không xảy ra xung đột ghi. Khoá duy nhất do childByAutoId 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ể dùng thông tin tham chiếu đến dữ liệu mới do phương thức childByAutoId trả về để lấy giá trị của khoá do hệ thống tự động tạo của đối tượng con hoặc đặt dữ liệu cho đối tượng con. Việc gọi getKey trên một giá trị tham chiếu childByAutoId sẽ trả về 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.

Theo dõi các sự kiện phụ

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 childByAutoId hoặc một thành phần con được cập nhật thông qua phương thức updateChildValues.

Loại sự kiện	Mức sử dụng thông thường
FIRDataEventTypeChildAdded	Truy xuất danh sách các mục hoặc theo dõi các mục được thêm vào danh sách. Sự kiện này được kích hoạt một lần cho mỗi thành phần con hiện có, sau đó kích hoạt lại mỗi khi một thành phần 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.
FIRDataEventTypeChildChanged	Theo dõi các 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 thành phần con.
FIRDataEventTypeChildRemoved	Lắng nghe các mục bị xoá khỏi danh sách. Sự kiện này được kích hoạt khi một phần tử con trực tiếp bị xoá.Ảnh chụp nhanh được truyền đến khối lệnh gọi lại chứa dữ liệu của phần tử con bị xoá.
FIRDataEventTypeChildMoved	Lắng nghe các thay đổi về thứ tự của các mục trong danh sách có thứ tự. Sự kiện này sẽ được kích hoạt bất cứ khi nào một bản cập nhật khiến thứ tự của thành phần con thay đổi. Tham số này được dùng với dữ liệu được sắp xếp theo queryOrderedByChild hoặc queryOrderedByValue.

Mỗi thành phần này có thể hữu ích khi bạn muốn 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 đồng thời các phương thức này để 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:

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

// Listen for new comments in the Firebase database
commentsRef.observe(.childAdded, with: { (snapshot) -> Void in
  self.comments.append(snapshot)
  self.tableView.insertRows(
    at: [IndexPath(row: self.comments.count - 1, section: self.kSectionComments)],
    with: UITableView.RowAnimation.automatic
  )
})
// Listen for deleted comments in the Firebase database
commentsRef.observe(.childRemoved, with: { (snapshot) -> Void in
  let index = self.indexOfMessage(snapshot)
  self.comments.remove(at: index)
  self.tableView.deleteRows(
    at: [IndexPath(row: index, section: self.kSectionComments)],
    with: UITableView.RowAnimation.automatic
  )
})

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

// Listen for new comments in the Firebase database
[_commentsRef
              observeEventType:FIRDataEventTypeChildAdded
              withBlock:^(FIRDataSnapshot *snapshot) {
                [self.comments addObject:snapshot];
                [self.tableView insertRowsAtIndexPaths:@[
                  [NSIndexPath indexPathForRow:self.comments.count - 1 inSection:kSectionComments]
                ]
                                      withRowAnimation:UITableViewRowAnimationAutomatic];
              }];
// Listen for deleted comments in the Firebase database
[_commentsRef
 observeEventType:FIRDataEventTypeChildRemoved
 withBlock:^(FIRDataSnapshot *snapshot) {
   int index = [self indexOfMessage:snapshot];
   [self.comments removeObjectAtIndex:index];
   [self.tableView deleteRowsAtIndexPaths:@[[NSIndexPath indexPathForRow:index inSection:kSectionComments]]
                         withRowAnimation:UITableViewRowAnimationAutomatic];
 }];

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

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

Việc đính kèm một trình theo dõi FIRDataEventTypeValue 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 DataSnapshot 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ả trùng 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. Để truy cập vào mục này, bạn cần lặp lại kết quả:

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

_commentsRef.observe(.value) { snapshot in
  for child in snapshot.children {
    ...
  }
}

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

[_commentsRef
              observeEventType:FIRDataEventTypeValue
              withBlock:^(FIRDataSnapshot *snapshot) {
                // Loop over children
                NSEnumerator *children = [snapshot children];
                FIRDataSnapshot *child;
                while (child = [children nextObject]) {
                  // ...
                }
              }];

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 bổ sung về thành phần con được thêm.

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

Bạn có thể dùng lớp Realtime Database FIRDatabaseQuery để 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 phần tử con. Bạn cũng có thể lọc kết quả đã sắp xếp theo một số lượng 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 các 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 để xác định cách sắp xếp kết quả:

Phương thức	Cách sử dụng
queryOrderedByKey	Sắp xếp kết quả theo khoá con.
queryOrderedByValue	Sắp xếp kết quả theo giá trị con.
queryOrderedByChild	Sắp xếp kết quả theo giá trị của một khoá con hoặc đường dẫn con lồng nhau được chỉ định.

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

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

// My top posts by number of stars
let myTopPostsQuery = ref.child("user-posts").child(getUid()).queryOrdered(byChild: "starCount")

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

// My top posts by number of stars
FIRDatabaseQuery *myTopPostsQuery = [[[self.ref child:@"user-posts"]
                                      child:[super getUid]]
                                     queryOrderedByChild:@"starCount"];

Truy vấn này truy xuất 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ủa họ, đượ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 phối dữ liệu. Bạn có thể đọc thêm về kỹ thuật này trong phần Cấu trúc cơ sở dữ liệu.

Lệnh gọi đến phương thức queryOrderedByChild chỉ định khoá con để sắp xếp kết quả theo. Trong ví dụ này, các bài đăng được sắp xếp theo giá trị của thành phần con "starCount" trong mỗi bài đăng. Bạn cũng có thể sắp xếp các truy vấn theo các 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ử 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 phần tử con được lồng trong lệnh gọi queryOrderedByChild.

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

 
let postsByMostPopular = ref.child("posts").queryOrdered(byChild: "metrics/views")

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

 
FIRDatabaseQuery *postsByMostPopular = [[ref child:@"posts"] queryOrderedByChild:@"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 bài viết 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 theo khi tạo truy vấn.

Phương thức	Cách sử dụng
queryLimitedToFirst	Đặt số lượng tối đa các mục cần trả về từ đầu danh sách kết quả có thứ tự.
queryLimitedToLast	Đặt số lượng tối đa các mục cần trả về từ cuối danh sách kết quả có thứ tự.
queryStartingAtValue	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 đã chọn.
queryStartingAfterValue	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 đã chọn.
queryEndingAtValue	Trả về các mục nhỏ hơn hoặc bằng khoá hoặc giá trị được chỉ định, tuỳ thuộc vào phương thức sắp xếp đã chọn.
queryEndingBeforeValue	Trả về các mục nhỏ hơn khoá hoặc giá trị được chỉ định, tuỳ thuộc vào phương thức sắp xếp đã chọn.
queryEqualToValue	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 bạn chọ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 hàm phạm vi. Ví dụ: bạn có thể kết hợp phương thức queryStartingAtValue và queryEndingAtValue để 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ể dùng các phương thức queryLimitedToFirst và queryLimitedToLast để đặt số lượng tối đa các phần tử con cần đồng bộ hoá cho một lệnh gọi lại nhất định. Ví dụ: nếu bạn dùng queryLimitedToFirst để đặt giới hạn là 100, ban đầu bạn sẽ chỉ nhận được tối đa 100 lệnh gọi lại FIRDataEventTypeChildAdded. 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 lệnh gọi lại FIRDataEventTypeChildAdded sẽ kích hoạt cho từng mục.

Khi các mục thay đổi, bạn sẽ nhận được các lệnh gọi lại FIRDataEventTypeChildAdded cho những mục xuất hiện trong truy vấn và các lệnh gọi lại FIRDataEventTypeChildRemoved cho những mục không còn trong truy vấn để tổng số vẫn là 100.

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

Swift

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys
let recentPostsQuery = (ref?.child("posts").queryLimited(toFirst: 100))!

Objective-C

Lưu ý: Sản phẩm Firebase này không có trên mục tiêu App Clip.

// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys
FIRDatabaseQuery *recentPostsQuery = [[self.ref child:@"posts"] queryLimitedToFirst:100];

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

Bạn có thể dùng queryStartingAtValue, queryStartingAfterValue, queryEndingAtValue, queryEndingBeforeValue và queryEqualToValue để chọn điểm bắt đầu, điểm kết thúc và điểm tương đương tuỳ ý cho các truy vấn. Điều này có thể hữu ích khi phân trang dữ liệu hoặc tìm các mục có phần tử con có một 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 dữ liệu được sắp xếp theo từng phương thức sắp xếp theo thứ tự trong lớp FIRDatabaseQuery.

queryOrderedByKey

Khi bạn dùng queryOrderedByKey để sắp xếp dữ liệu, dữ liệu sẽ được trả về theo thứ tự tăng dần theo khoá.

1. Trẻ em có khoá có thể 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. 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ự từ điển tăng dần.

queryOrderedByValue

Khi sử dụng queryOrderedByValue, 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 queryOrderedByChild, ngoại trừ việc giá trị của nút được dùng thay vì giá trị của một khoá con được chỉ định.

queryOrderedByChild

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

1. Những trẻ có giá trị nil 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 thành phần con có giá trị false, thì các thành phần con đó sẽ được sắp xếp theo thứ tự từ điển 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 thành phần con có giá trị là true, thì các thành phần con đó sẽ được sắp xếp theo thứ tự từ điển theo khoá.
4. Tiếp theo là các phần tử con có giá trị bằng số, được sắp xếp theo thứ tự tăng dần. Nếu nhiều phầ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 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 phần tử con có cùng giá trị cho nút con được chỉ định, thì các phần tử con đó 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.

Tách trình nghe

Người quan sát không tự động ngừng đồng bộ hoá dữ liệu khi bạn rời khỏi ViewController. Nếu không được xoá đúng cách, đối tượng theo dõi sẽ tiếp tục đồng bộ hoá dữ liệu vào bộ nhớ cục bộ và sẽ giữ lại mọi đối tượng được ghi lại trong bao đóng trình xử lý sự kiện, điều này có thể gây ra tình trạng rò rỉ bộ nhớ. Khi không cần đến đối tượng tiếp nhận dữ liệu nữa, hãy xoá đối tượng đó bằng cách truyền FIRDatabaseHandle được liên kết đến phương thức removeObserverWithHandle.

Khi bạn thêm một khối gọi lại vào một tham chiếu, FIRDatabaseHandle sẽ được trả về. Bạn có thể dùng các đối tượng này để xoá khối lệnh gọi lại.

Nếu nhiều trình nghe đã được thêm vào một tham chiếu cơ sở dữ liệu, thì mỗi trình nghe sẽ được gọi khi một sự kiện được tạo. Để ngừng đồng bộ hoá dữ liệu tại vị trí đó, bạn phải xoá tất cả các đối tượng theo dõi tại một vị trí bằng cách gọi phương thức removeAllObservers.

Việc gọi removeObserverWithHandle hoặc removeAllObservers trên một trình nghe không tự động xoá các trình nghe đã đăng ký trên các nút con của trình nghe đó; bạn cũng phải theo dõi các tham chiếu hoặc xử lý đó để xoá chúng.

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