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

Tài liệu này trình bày cách làm việc với danh sách dữ liệu trong Firebase. Để tìm hiểu những kiến thức cơ bản về cách đọc và ghi dữ liệu Firebase, hãy xem bài viết Đọc và ghi dữ liệu trên Android.

Lấy DatabaseReference

Để đọc và ghi dữ liệu từ cơ sở dữ liệu, bạn cần có một thực thể của DatabaseReference:

Kotlin

private lateinit var database: DatabaseReference
// ...
database = Firebase.database.reference
ReadAndWriteSnippets.kt

Java

private DatabaseReference mDatabase;
// ...
mDatabase = FirebaseDatabase.getInstance().getReference();
ReadAndWriteSnippets.java

Đọc và ghi danh sách

Thêm vào danh sách dữ liệu

Sử dụng phương thức push() để 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 push() 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 mỗi phần tử mới trong danh sách, nhiều ứ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 bị xung đột khi 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 trình tự thời gian.

Bạn có thể sử dụng tham chiếu đến dữ liệu mới do phương thức push() 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 tham chiếu push() sẽ trả về giá trị củ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 đầu ra dữ liệu .

Theo dõi sự kiện phần tử con

Khi làm việc với danh sách, ứng dụng của bạn nên theo dõi các sự kiện phần tử con thay vì các sự kiện giá trị được dùng cho các đối tượng riêng lẻ.

Các sự kiện phần tử 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 push() hoặc một phần tử con đang được cập nhật thông qua phương thức updateChildren(). Mỗi sự kiện 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.

Để theo dõi các sự kiện phần tử con trên DatabaseReference, hãy đính kèm ChildEventListener:

Trình nghe Lệnh gọi lại sự kiện Cách sử dụng thông thường
ChildEventListener onChildAdded() 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 các mục. Lệnh gọi lại này được kích hoạt một lần cho mỗi phần tử con hiện có, sau đó 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. `DataSnapshot` được truyền đến trình theo dõi chứa dữ liệu của phần tử con mới.
onChildChanged() 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ứ lúc nào một nút phần tử con được sửa đổi, bao gồm cả mọi sửa đổi đối với các phần tử con của nút phần tử con. The DataSnapshot được truyền đến trình theo dõi 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. The DataSnapshot được truyền đến lệnh gọi lại sự kiện chứa dữ liệu cho phần tử 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 được sắp xếp. Sự kiện này được kích hoạt bất cứ khi nào lệnh gọi lại onChildChanged() được kích hoạt bởi một bản cập nhật khiến phần tử con được sắp xếp lại. Sự kiện này được dùng với dữ liệu được sắp xếp bằng orderByChild hoặc orderByValue.

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ạ bên dưới:

Kotlin 

val childEventListener = object : ChildEventListener {
    override fun onChildAdded(dataSnapshot: DataSnapshot, previousChildName: String?) {
        Log.d(TAG, "onChildAdded:" + dataSnapshot.key!!)

        // A new comment has been added, add it to the displayed list
        val comment = dataSnapshot.getValue<Comment>()

        // ...
    }

    override fun onChildChanged(dataSnapshot: DataSnapshot, previousChildName: String?) {
        Log.d(TAG, "onChildChanged: ${dataSnapshot.key}")

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so displayed the changed comment.
        val newComment = dataSnapshot.getValue<Comment>()
        val commentKey = dataSnapshot.key

        // ...
    }

    override fun onChildRemoved(dataSnapshot: DataSnapshot) {
        Log.d(TAG, "onChildRemoved:" + dataSnapshot.key!!)

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so remove it.
        val commentKey = dataSnapshot.key

        // ...
    }

    override fun onChildMoved(dataSnapshot: DataSnapshot, previousChildName: String?) {
        Log.d(TAG, "onChildMoved:" + dataSnapshot.key!!)

        // A comment has changed position, use the key to determine if we are
        // displaying this comment and if so move it.
        val movedComment = dataSnapshot.getValue<Comment>()
        val commentKey = dataSnapshot.key

        // ...
    }

    override fun onCancelled(databaseError: DatabaseError) {
        Log.w(TAG, "postComments:onCancelled", databaseError.toException())
        Toast.makeText(
            context,
            "Failed to load comments.",
            Toast.LENGTH_SHORT,
        ).show()
    }
}
databaseReference.addChildEventListener(childEventListener)
QueryActivity.kt

Java 

ChildEventListener childEventListener = new ChildEventListener() {
    @Override
    public void onChildAdded(DataSnapshot dataSnapshot, String previousChildName) {
        Log.d(TAG, "onChildAdded:" + dataSnapshot.getKey());

        // A new comment has been added, add it to the displayed list
        Comment comment = dataSnapshot.getValue(Comment.class);

        // ...
    }

    @Override
    public void onChildChanged(DataSnapshot dataSnapshot, String previousChildName) {
        Log.d(TAG, "onChildChanged:" + dataSnapshot.getKey());

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so displayed the changed comment.
        Comment newComment = dataSnapshot.getValue(Comment.class);
        String commentKey = dataSnapshot.getKey();

        // ...
    }

    @Override
    public void onChildRemoved(DataSnapshot dataSnapshot) {
        Log.d(TAG, "onChildRemoved:" + dataSnapshot.getKey());

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so remove it.
        String commentKey = dataSnapshot.getKey();

        // ...
    }

    @Override
    public void onChildMoved(DataSnapshot dataSnapshot, String previousChildName) {
        Log.d(TAG, "onChildMoved:" + dataSnapshot.getKey());

        // A comment has changed position, use the key to determine if we are
        // displaying this comment and if so move it.
        Comment movedComment = dataSnapshot.getValue(Comment.class);
        String commentKey = dataSnapshot.getKey();

        // ...
    }

    @Override
    public void onCancelled(DatabaseError databaseError) {
        Log.w(TAG, "postComments:onCancelled", databaseError.toException());
        Toast.makeText(mContext, "Failed to load comments.",
                Toast.LENGTH_SHORT).show();
    }
};
databaseReference.addChildEventListener(childEventListener);
QueryActivity.java

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

Mặc dù việc sử dụng ChildEventListener là cách được đề xuất để đọc danh sách dữ liệu, nhưng trong một số trường hợp, việc đính kèm ValueEventListener vào tham chiếu danh sách sẽ hữu ích.

Việc đính kèm ValueEventListener 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, 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ả:

Kotlin 

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        for (postSnapshot in dataSnapshot.children) {
            // TODO: handle the post
        }
    }

    override fun onCancelled(databaseError: DatabaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException())
        // ...
    }
})
QueryActivity.kt

Java 

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot dataSnapshot) {
        for (DataSnapshot postSnapshot: dataSnapshot.getChildren()) {
            // TODO: handle the post
        }
    }

    @Override
    public void onCancelled(@NonNull DatabaseError databaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException());
        // ...
    }
});
QueryActivity.java

Mẫu này có thể hữu ích khi bạn muốn tìm nạp tất cả cá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 onChildAdded bổ sung.

Tách trình theo dõi

Các lệnh gọi lại sẽ bị xoá bằng cách gọi phương thức removeEventListener() trên tham chiếu cơ sở dữ liệu Firebase.

Nếu một trình theo dõi đã được thêm nhiều lần vào một vị trí dữ liệu, thì trình theo dõi đó sẽ được gọi nhiều lần cho mỗi sự kiện và bạn phải tách trình theo dõi đó cùng số lần để xoá hoàn toàn.

Việc gọi removeEventListener() trên một trình theo dõi mẹ không tự động xoá các trình theo dõi đã đăng ký trên các nút phần tử con của trình theo dõi đó; bạn cũng phải gọi removeEventListener() trên mọi trình theo dõi phần tử con để xoá lệnh gọi lại.

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

Bạn có thể sử dụng lớp Realtime Database Query để 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 thành một số kết quả cụ thể hoặc một phạm vi 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 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 một khoá phần tử con được chỉ định hoặc đường dẫn phần tử con lồng nhau.
orderByKey() Sắp xếp kết quả theo khoá phần tử con.
orderByValue() Sắp xếp kết quả theo giá trị phần tử con.

Bạn chỉ có thể sử dụng một phương thức sắp xếp theo thứ tự tại một thời điểm. Việc gọi phương thức sắp xếp theo thứ tự 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ượt thích:

Kotlin 

// My top posts by number of stars
val myUserId = uid
val myTopPostsQuery = databaseReference.child("user-posts").child(myUserId)
    .orderByChild("starCount")

myTopPostsQuery.addChildEventListener(object : ChildEventListener {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
})
QueryActivity.kt

Java 

// My top posts by number of stars
String myUserId = getUid();
Query myTopPostsQuery = databaseReference.child("user-posts").child(myUserId)
        .orderByChild("starCount");
myTopPostsQuery.addChildEventListener(new ChildEventListener() {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
});
QueryActivity.java

Thao tác này xác định một truy vấn mà khi kết hợp với trình theo dõi phần tử 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ã người dùng của họ, được sắp xếp theo số lượt thích 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 đầu ra 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 orderByChild() chỉ định khoá phần tử con để sắp xếp kết quả theo. 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 tương ứng "starCount". 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 ví dụ này, chúng ta có thể sắp xếp các phần tử danh sách theo các 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 lồng nhau trong lệnh gọi orderByChild().

Kotlin 

// Most viewed posts
val myMostViewedPostsQuery = databaseReference.child("posts")
    .orderByChild("metrics/views")
myMostViewedPostsQuery.addChildEventListener(object : ChildEventListener {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
})
QueryActivity.kt

Java 

// Most viewed posts
Query myMostViewedPostsQuery = databaseReference.child("posts")
        .orderByChild("metrics/views");
myMostViewedPostsQuery.addChildEventListener(new ChildEventListener() {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
});
QueryActivity.java

Để 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 thứ tự khi tạo truy vấn.

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ả được 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ả được 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ề các mục nhỏ 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.
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 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 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 startAt() và endAt() để giới hạn kết quả trong một phạm vi giá trị được chỉ định.

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

Kotlin 

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        for (postSnapshot in dataSnapshot.children) {
            // TODO: handle the post
        }
    }

    override fun onCancelled(databaseError: DatabaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException())
        // ...
    }
})
QueryActivity.kt

Java 

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot dataSnapshot) {
        for (DataSnapshot postSnapshot: dataSnapshot.getChildren()) {
            // TODO: handle the post
        }
    }

    @Override
    public void onCancelled(@NonNull DatabaseError databaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException());
        // ...
    }
});
QueryActivity.java

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 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 sử dụng limitToFirst() để đặ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 onChildAdded(). 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 onChildAdded() 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 onChildAdded() cho các mục nhập truy vấn và lệnh gọi lại onChildRemoved() cho các mục bị loại khỏi truy vấn để tổng số vẫn là 100.

Ví dụ sau đây minh hoạ cách ứng dụng 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:

Kotlin 

// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys.
databaseReference.child("posts").limitToFirst(100)
QueryActivity.kt

Java 

// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys
Query recentPostsQuery = databaseReference.child("posts")
        .limitToFirst(100);
QueryActivity.java

Ví dụ này chỉ xác định một truy vấn. Để thực sự đồng bộ hoá dữ liệu, truy vấn này cần có một trình theo dõi được đí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 các điểm bắt đầu, kết thúc và tương đương tuỳ ý cho các 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 theo thứ tự trong lớp Query.

orderByChild

Khi sử dụng orderByChild(), dữ liệu chứa khoá phần tử con được chỉ định sẽ được sắp xếp như sau:

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

orderByValue

Khi sử dụng orderByValue(), các phần tử con sẽ được sắp xếp theo giá trị của chúng. 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 một khoá phần tử con được chỉ định.

Các bước tiếp theo