Làm việc với Danh sách dữ liệu trên nền tảng Apple

Nhận FIRDatabaseReference

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

Nhanh

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

ref = Database.database().reference()

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn trên mục tiêu App Clip.
@property (strong, nonatomic) FIRDatabaseReference *ref;

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

Danh sách đọc và viết

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 danh sách trong các ứng dụng nhiều người dùng. Phương thức childByAutoId tạo một khóa 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 khóa được tạo tự động này cho từng thành phần mới trong danh sách, một số khách hàng có thể thêm các thành phần con vào cùng một vị trí cùng lúc mà không bị xung đột khi ghi. Khóa duy nhất do childByAutoId tạo dựa trên dấu thời gian, do đó các mục trong danh sách được tự động sắp xếp theo thứ 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ị của khóa được tạo tự động hoặc dữ liệu tập hợp cho trẻ. Gọi getKey trên tham chiếu childByAutoId sẽ trả về khóa được tạo tự động.

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

Lắng nghe các sự kiện trẻ em

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

Loại sự kiện Cách sử dụng điển hình
FIRDataEventTypeChildAdded 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. 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ó và sau đó được kích hoạt lại mỗi khi 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.
FIRDataEventTypeChildChanged Lắng nghe 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 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. Ảnh chụp nhanh được chuyển tới trình xử lý sự kiện chứa dữ liệu cập nhật cho trẻ.
FIRDataEventTypeChildRemoved Lắng nghe các mục bị xóa khỏi danh sách. Sự kiện này được kích hoạt khi một thành phần con ngay lập tức bị xóa. Ảnh chụp nhanh được chuyển đến khối gọi lại chứa dữ liệu về thành phần con bị xóa.
FIRDataEventTypeChildMoved Lắng nghe những thay đổi về thứ tự của các mục trong danh sách có 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 gây ra sự sắp xếp lại của trẻ. Nó được sử dụng với dữ liệu được sắp xếp theo queryOrderedByChild hoặc queryOrderedByValue .

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 ứ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 các nhận xét của bài đăng, như minh họa bên dưới:

Nhanh

Lưu ý: Sản phẩm Firebase này không có sẵn 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
  )
})

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn 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];
 }];

Lắng nghe các sự kiện giá trị

Mặc dù việc lắng nghe các sự kiện con là cách được khuyến nghị để đọc danh sách dữ liệu, nhưng có những tình huống việc nghe các sự kiện có giá trị trong tham chiếu danh sách lại rất 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 DataSnapshot duy nhất, sau đó bạn có thể lặp lại để truy cập từng phần tử con.

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. Để truy cập mục, bạn cần lặp lại kết quả:

Nhanh

Lưu ý: Sản phẩm Firebase này không có sẵn trên mục tiêu App Clip.
_commentsRef.observe(.value) { snapshot in
  for child in snapshot.children {
    ...
  }
}

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn 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 sự kiện con của một danh sách trong một thao tác duy nhất, thay vì lắng nghe các sự kiện bổ sung được thêm vào con.

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

Bạn có thể sử dụng lớp FIRDatabaseQuery 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
queryOrderedByKey Sắp xếp kết quả theo khóa 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 khóa con được chỉ định hoặc đường dẫn con lồng nhau.

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 minh họa 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ố sao của họ:

Nhanh

Lưu ý: Sản phẩm Firebase này không có sẵn 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")

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn 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 ID người dùng của họ, được sắp xếp theo số sao mà mỗi bài đăng đã nhận được. Kỹ thuật sử dụng ID làm khóa chỉ mục này được gọi là data fan out, bạn có thể đọc thêm về nó trong Cấu trúc cơ sở dữ liệu của bạn .

Lệnh gọi phương thức queryOrderedByChild chỉ định khóa 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 phần tử con "starCount" trong mỗi bài đăng. Các truy vấn cũng có thể được sắp xếp theo thứ tự con lồng nhau, 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 thành phần trong danh sách theo các giá trị được lồng trong khóa 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 của chúng ta.

Nhanh

Lưu ý: Sản phẩm Firebase này không có sẵn trên mục tiêu App Clip.
 
let postsByMostPopular = ref.child("posts").queryOrdered(byChild: "metrics/views")

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn 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 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
queryLimitedToFirst Đặ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.
queryLimitedToLast Đặ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.
queryStartingAtValue 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.
queryStartingAfterValue Trả về các mục lớn hơn khóa hoặc giá trị đã chỉ định, tùy thuộc vào phương pháp theo thứ tự đã chọn.
queryEndingAtValue 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.
queryEndingBeforeValue Trả về các mục nhỏ hơn khóa hoặc giá trị được chỉ định, tùy thuộc vào phương pháp theo thứ tự đã chọn.
queryEqualToValue 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 pháp 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 queryStartingAtValuequeryEndingAtValue để giới hạn kết quả ở 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 queryLimitedToFirstqueryLimitedToLast để đặt số lượng phần tử con tối đa sẽ đượ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 queryLimitedToFirst để đặ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 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ục.

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 truy vấn và lệnh gọi lại FIRDataEventTypeChildRemoved cho các mục bị loại bỏ để tổng số vẫn ở mức 100.

Ví dụ sau đây minh họa 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:

Nhanh

Lưu ý: Sản phẩm Firebase này không có sẵn 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))!

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không có sẵn 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 khóa hoặc giá trị

Bạn có thể sử dụng queryStartingAtValue , queryStartingAfterValue , queryEndingAtValue , queryEndingBeforeValuequeryEqualToValue để 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 FIRDatabaseQuery .

queryOrderedByKey

Khi sử dụng queryOrderedByKey để 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.

  1. 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.
  2. 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.

queryOrderedByValue

Khi sử dụng queryOrderedByValue , 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 queryOrderedByChild , 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.

queryOrderedByChild

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

  1. Trẻ em có giá trị nil cho khóa con được chỉ định sẽ được ưu tiên trước.
  2. 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.
  3. Tiếp theo là các phần tử con 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.
  4. 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.
  5. 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.
  6. 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.

Tách người nghe

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

Khi bạn thêm khối gọi lại vào tham chiếu, FIRDatabaseHandle sẽ được trả về. Những tay cầm này có thể được sử dụng để loại bỏ khối 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 đưa ra. Để ngừng đồng bộ hóa dữ liệu tại vị trí đó, bạn phải xóa tất cả người quan sát 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 trình nghe không tự động xóa trình nghe đã đăng ký trên các nút con của nó; bạn cũng phải theo dõi các tham chiếu hoặc thẻ điều khiển đó để xóa chúng.

Bước tiếp theo