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

Lấy 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:

var ref: DatabaseReference!

ref = Database.database().reference()

@property (strong, nonatomic) FIRDatabaseReference *ref;

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

Đọ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 tạo một khoá duy nhất mỗi khi một phần tử con mới được thêm vào tệp đối 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 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ể sử dụng tệp đối chiếu với dữ liệu mới do phương thức childByAutoId trả về để lấy giá trị của khoá được tạo tự động của phần tử con hoặc đặt dữ liệu cho phần tử con. Việc gọi getKey trên tệp đối 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 sự kiện con

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 phần tử con của một nút từ một thao tác, chẳng hạn như một phần tử con mới được thêm thông qua phương thức childByAutoId hoặc một phần tử con được cập nhật thông qua phương thức updateChildValues.

Mỗi phương thức 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 viết 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:

// 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
  )
})

// 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 sự kiện giá trị

Mặc dù việc theo dõi các sự kiện con là cách nên dùng để đọc danh sách dữ liệu, nhưng cũng có những trường hợp việc theo dõi các sự kiện giá trị trên một tệp đối chiếu danh sách là 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 vào từng phần tử con.

Ngay cả khi chỉ có một kết quả 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, bạn cần lặp lại kết quả:

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

[_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 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 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ị.

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 pháp 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 pháp sắp xếp tại một thời điểm. Việc gọi một 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ố sao:

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

// 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. 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 bài viết 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ả. 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. Bạn cũng có thể sắp xếp 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ử trong danh sách theo giá trị lồng trong khoá metrics bằng cách chỉ định đường dẫn tương đối đến phần tử con lồng trong lệnh gọi queryOrderedByChild.

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

 
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 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 pháp giới hạn hoặc phạm vi nào với một phương pháp 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 queryStartingAtValue và queryEndingAtValue để giới hạn kết quả trong một dải 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 số lượng phần tử con tối đa được đồ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, 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, thì lệnh gọi lại FIRDataEventTypeChildAdded sẽ kích hoạt cho mỗi 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 vào truy vấn và lệnh gọi lại FIRDataEventTypeChildRemoved cho các mục bị loại bỏ khỏi truy vấn để tổng số mục luôn là 100.

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

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

// 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, đ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 pháp sắp xếp 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. 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, đượ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 phần tử 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 sử dụng thay vì 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. Các thành phần con có giá trị nil cho khoá con được 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 được chỉ định. Nếu nhiều thành phần con có giá trị false, thì các thành phần đó 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 được chỉ định. Nếu nhiều phần tử con có giá trị true, thì các phần tử đó 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 phần tử con có cùng giá trị số cho nút con được chỉ định, thì các phầ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 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. Đối tượng nằm ở cuối và được sắp xếp theo thứ tự bảng chữ cái theo khoá theo thứ tự tăng dần.

Tách trình nghe

Trình quan sát không tự động ngừng đồng bộ hoá dữ liệu khi bạn rời khỏi một ViewController. Nếu không được xoá đúng cách, trình quan sát sẽ tiếp tục đồng bộ hoá dữ liệu với bộ nhớ cục bộ và giữ lại mọi đối tượng được ghi lại trong hàm đóng của trình xử lý sự kiện, điều này có thể gây rò rỉ bộ nhớ. Khi không cần trình quan sát nữa, hãy xoá trình quan sát đó 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 lệnh gọi lại vào một tệp đối chiếu, hệ thống sẽ trả về một FIRDatabaseHandle. 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 nhiều trình nghe đã được thêm vào một tệp đối chiếu cơ sở dữ liệu, thì mỗi trình nghe sẽ được gọi khi một sự kiện được kích hoạt. Để ngừng đồng bộ hoá dữ liệu tại vị trí đó, bạn phải xoá tất cả trình 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 xoá trình nghe đã đăng ký trên các nút con; bạn cũng phải theo dõi các tệp đối chiếu hoặc trình 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