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

Tải FIRDatabaseReference

Để đọ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 FIRDatabaseReference:

Swift

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

var ref: DatabaseReference!

ref = Database.database().reference()

Objective-C

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

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

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

Theo dõi các sự kiện của trẻ

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 phần tử con của một nút từ một thao tác, chẳng hạn như phần tử con mới được thêm vào thông qua childByAutoId hoặc phần tử con được cập nhật thông qua 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 để 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 nhà xuất bản con hiện có, rồi kích hoạt lại mỗi khi thêm một thành phần con mới vào đường dẫn được chỉ định. Trình nghe là đã chuyển một ảnh chụp nhanh có chứa dữ liệu của nhà xuất bản con mới.
FIRDataEventTypeChildChanged	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 sửa đổi đối với các phần tử con của nút con. Thông tin tổng quan 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.
FIRDataEventTypeChildRemoved	Nghe các mục bị xoá khỏi danh sách. Sự kiện này được kích hoạt khi phần tử con tức thì sẽ bị xoá.Ảnh chụp nhanh được truyền đến khối gọi lại chứa dữ liệu của phần tử con đã bị xoá.
FIRDataEventTypeChildMoved	Theo dõi những thay đổi đối với thứ tự của các mục trong danh sách theo thứ tự. Sự kiện này được kích hoạt bất cứ khi nào một bản cập nhật dẫn đến việc sắp xếp lại thứ tự của trẻ. Tham số này được dùng với dữ liệu được sắp xếp theo queryOrderedByChild hoặc queryOrderedByValue.

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

Swift

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

// 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 dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

// 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ù bạn nên theo dõi các sự kiện con để đọc danh sách dữ liệu, có những trường hợp việc theo dõi các sự kiện giá trị trên một tham chiếu danh sách lại hữu ích.

Việc đính kèm trình quan sát 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 DataSnapảnh duy nhất mà sau đó bạn có thể lặp lại để truy cập vào từng mục con.

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

Swift

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

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

Objective-C

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

[_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ả phần tử con của một danh sách trong một thao tác thay vì theo dõi thêm trẻ được thêm vào sự kiện.

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

Bạn có thể sử dụng lớp FIRDatabaseQuery của Cơ sở dữ liệu theo thời gian thực để 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ả được sắp xếp cho 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ể gây tốn kém, đặc biệt khi thực hiện trên khách hàng. 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 những truy vấn đó trên máy chủ và cải thiện hiệu suất truy vấn như được mô tả trong Lập chỉ mục dữ liệu của bạn.

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
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 đã chỉ định hoặc đường dẫn con lồng nhau.

Mỗi lần, bạn chỉ có thể sử dụng một phương thức đặt hàng. Gọi một phương thức đặt hàng nhiều lần trong cùng một truy vấn sẽ gây ra lỗi.

Ví dụ sau minh hoạ cách truy xuất danh sách thông tin bài đăng hàng đầu được sắp xếp theo số sao:

Swift

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

// 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 dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

// 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ố sao mà mỗi bài đăng nhận được. Chiến dịch này kỹ thuật sử dụng ID làm khoá chỉ mục được gọi là dữ liệu bị tách ra. Bạn có thể đọc thông tin khác về sản phẩm này trong Xây dựng cấu trúc cơ sở dữ liệu của bạn.

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

Swift

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

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

Objective-C

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

 
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, 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 pháp giới hạn hoặc phạm vi nào với theo thứ tự khi tạo truy vấn.

Phương thức	Cách sử dụng
queryLimitedToFirst	Đặt số lượng mục tối đa cần trả về từ đầu danh sách kết quả theo thứ tự.
queryLimitedToLast	Đặt số lượng mặt hàng tối đa cần trả về tính từ cuối đơn đặt hàng danh sách kết quả.
queryStartingAtValue	Trả về các mục lớn hơn hoặc bằng khoá hoặc giá trị đã chỉ định, tuỳ theo phương thức đã chọn.
queryStartingAfterValue	Trả về các mục lớn hơn khoá hoặc giá trị đã chỉ định, tuỳ theo phương thức đã chọn.
queryEndingAtValue	Trả về các mục nhỏ hơn hoặc bằng khoá hoặc giá trị đã chỉ định, tuỳ theo phương thức đã chọn.
queryEndingBeforeValue	Trả về các mục nhỏ hơn khoá hoặc giá trị đã chỉ định, tuỳ theo phương thức đã 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 pháp sắp xếp theo phương thức đã chọn.

Không giống như các phương thức theo thứ tự, 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 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 queryLimitedToFirst và queryLimitedToLast để đặt giá trị số lượng phần tử 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 queryLimitedToFirst để đặt giới hạn là 100, ban đầu bạn chỉ nhận được thành 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, lệnh gọi lại FIRDataEventTypeChildAdded sẽ kích hoạt cho từng mặt hàng.

Khi các mục thay đổi, bạn sẽ nhận được lệnh gọi lại FIRDataEventTypeChildAdded cho các mục nhập và lệnh gọi lại FIRDataEventTypeChildRemoved cho các mục bị loại bỏ để thì tổng số vẫn là 100.

Ví dụ sau minh hoạ cách một ứng dụng viết 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 dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

// 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 dùng được trên mục tiêu App Clip (Đoạn video ứng dụng).

// 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ể sử dụng queryStartingAtValue, queryStartingAfterValue, queryEndingAtValue, queryEndingBeforeValue và queryEqualToValue để chọn điểm bắt đầu, kết thúc và điểm tương đương cho truy vấn. Chiến dịch 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 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 trong Lớp FIRDatabaseQuery.

queryOrderedByKey

Khi sử 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. 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ẽ đứng trước và được sắp xếp theo thứ tự tăng dần.
2. Phần tử con có giá trị chuỗi là khoá tiếp theo, được sắp xếp theo từ điển theo thứ tự tăng dần.

queryOrderedByValue

Khi sử dụng queryOrderedByValue, phần tử con được sắp xếp theo giá trị. Thứ tự tiêu chí sẽ giống như trong queryOrderedByChild, ngoại trừ giá trị của nút là được dùng thay cho giá trị của 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. Phần tử con có giá trị nil cho khoá con đã chỉ định sẽ xuất hiện đầu tiên.
2. Khoá con được chỉ định có giá trị false tiếp theo. Nếu nhiều phần tử con có giá trị false, thì chúng sẽ được sắp xếp theo từ điển theo khoá.
3. Khoá con được chỉ định có giá trị true tiếp theo. 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 khoá.
4. Các phần tử 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 phần tử con có cùng giá trị số cho phần tử con được chỉ định nút, chúng được sắp xếp theo khoá.
5. Chuỗi đứng sau số và được sắp xếp theo từ điển theo thứ tự tăng dần đơn đặt hàng. Nếu nhiều phần tử con có cùng giá trị đối với phần tử con được chỉ định nút, các nút này được sắp xếp từ vựng theo khoá.
6. Đối tượng đứng cuối và được sắp xếp theo từ điển theo khoá theo thứ tự tăng dần.

Tách trình nghe

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

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

Nếu bạn thêm nhiều trình nghe 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 xảy ra. Để ngừng đồng bộ hoá dữ liệu tại vị trí đó, bạn phải xoá tất cả người quan sát tại một vị trí bằng cách gọi removeAllObservers .

Việc gọi removeObserverWithHandle hoặc removeAllObservers trên một trình nghe sẽ không tự động xoá trình nghe đã đăng ký trên các nút con; bạn cũng phải hãy theo dõi các tệp tham chiếu hoặc tên người dùng đó để xoá chúng.

Các bước tiếp theo

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