Trang này được dịch bởi Cloud Translation API.
Switch to English

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

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

Nhận cơ sở dữ liệu

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

Java

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

Kotlin + KTX

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

Đọc và ghi danh sách

Nối vào danh sách dữ liệu

Sử dụng phương thức push() để 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 push() tạo một khóa duy nhất mỗi khi một đứa trẻ mới được thêm vào tham chiếu Firebase được chỉ định. Bằng cách sử dụng các khóa đượ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 khách 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 khi ghi. Khóa duy nhất được tạo bởi push() dựa trên dấu thời gian, vì vậy các mục 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 trả về bởi phương thức push() để nhận giá trị của khóa được tạo tự động của trẻ hoặc dữ liệu đặt cho trẻ. Gọi getKey() trên tham chiếu push() trả về giá trị của 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 bạn. Để biết thêm thông tin, hãy xem ví dụ về quạt dữ liệu.

Nghe các sự kiện trẻ em

Khi làm việc với các danh sách, ứng dụng của bạn nên lắng nghe các sự kiện con hơn là các sự kiện giá trị được sử dụng cho các đối tượng đơn lẻ.

Các sự kiện con được kích hoạt để đáp ứng với các hoạt động cụ thể xảy ra với các nút con từ một hoạt động chẳng hạn như một con mới được thêm vào thông qua phương thức push() hoặc một con được cập nhật thông qua phương thức updateChildren() . Mỗi thứ kết hợp với nhau có thể hữu ích cho việc lắng nghe các thay đổi đối với một nút cụ thể trong cơ sở dữ liệu.

Để lắng nghe các sự kiện con trên DatabaseReference , hãy đính kèm một ChildEventListener :

Thính giả Sự kiện gọi lại Cách sử dụng điển hình
ChildEventListener onChildAdded() Truy xuất danh sách các mặt hàng hoặc lắng nghe bổ sung vào danh sách các mặt hàng. Cuộc gọi lại này được kích hoạt một lần cho mỗi đứa trẻ hiện có và sau đó mỗi lần một đứa trẻ mới được thêm vào đường dẫn đã chỉ định. DataSnapshot được truyền cho người nghe chứa dữ liệu mới của con.
onChildChanged() Lắng nghe 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 kỳ khi nào nút con được sửa đổi, bao gồm bất kỳ sửa đổi nào đối với con cháu của nút con. DataSnapshot được truyền cho người nghe sự kiện chứa dữ liệu cập nhật cho trẻ.
onChildRemoved() Lắng nghe các mục bị xóa khỏi danh sách. DataSnapshot được truyền cho cuộc gọi lại sự kiện chứa dữ liệu cho con bị loại bỏ.
onChildMoved() Lắng nghe những thay đổi về thứ tự của các mục trong một danh sách được sắp xếp. Sự kiện này được kích hoạt bất cứ khi nào cuộc gọi lại onChildChanged() được kích hoạt bởi một bản cập nhật gây ra sự sắp xếp lại của đứa trẻ. Nó được sử dụng với dữ liệu được sắp xếp với orderByChild hoặc orderByValue .

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 để giám sát hoạt động trong nhận xét của một bài đăng, như được hiển thị bên dưới:

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();
    }
};
ref.addChildEventListener(childEventListener);

Kotlin + KTX

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)

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

Mặc dù sử dụng ChildEventListener là cách được khuyến nghị để đọc danh sách dữ liệu, có những tình huống khi đính kèm ValueEventListener vào tham chiếu danh sách là hữu ích.

Gắn một ValueEventListener vào một danh sách các dữ liệu sẽ trả lại toàn bộ danh sách các dữ liệu dưới dạng đĩa đơn DataSnapshot , mà bạn có thể sau đó lặp trên để truy cập từng trẻ.

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

Java

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

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

Kotlin + KTX

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

Mẫu này có thể hữu ích khi bạn muốn tìm nạp tất cả con của một danh sách trong một thao tác, thay vì nghe các sự kiện onChildAdded bổ sung.

Tách người nghe

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

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

Gọi removeEventListener() trên trình nghe cha mẹ không tự động loại bỏ các trình nghe đã đăng ký trên các nút con của nó; removeEventListener() cũng phải được gọi trên bất kỳ trình nghe con nào để loại bỏ cuộc gọi lại.

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

Bạn có thể sử dụng lớp Query 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 một đứa trẻ. Bạn cũng có thể lọc kết quả được sắp xếp theo một số kết quả cụ thể hoặc một loạt các khóa hoặc giá trị.

Sắp xếp dữ liệu

Để lấy 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 theo thứ tự để xác định cách kết quả được sắp xếp:

phương pháp Sử dụng
orderByChild() 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.
orderByKey() Thứ tự kết quả bằng khóa con.
orderByValue() Kết quả thứ tự theo giá trị con.

Bạn chỉ có thể sử dụng một phương thức theo thứ tự tại một thời điểm. 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 đây cho thấy 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ọ:

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

Kotlin + KTX

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

Điều này xác định một truy vấn mà khi kết hợp với một trình nghe con đồng bộ hóa máy khách 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 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à quạt dữ liệu, bạn có thể đọc thêm về nó trong Cấu trúc cơ sở dữ liệu của bạn .

Cuộc gọi đến phương thức orderByChild() chỉ định khóa 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 con "starCount" tương ứng. Các câu hỏi cũng có thể được sắp xếp bởi những đứa trẻ lồng nhau, trong trường hợp bạn có dữ liệu giống như thế này:

"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 thành phần danh sách của mình 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 con được lồng trong lệnh gọi orderByChild() của chúng ta.

Java

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

Kotlin + KTX

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

Để biết thêm thông tin về cách sắp xếp các kiểu dữ liệu khác, hãy xem Cách dữ liệu truy vấn được sắp xếp .

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 theo thứ tự khi xây dựng truy vấn.

phương pháp Sử dụng
limitToFirst() Đặt số lượng mục tối đa để trả về từ đầu danh sách kết quả có thứ tự.
limitToLast() Đặt số lượng mục tối đa để trả về từ cuối danh sách kết quả được đặt hàng.
startAt() 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 thức đặt hàng được chọn.
endAt() 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 thức đặt hàng đã chọn.
equalTo() Trả lại các mặt hàng bằng khóa hoặc giá trị được chỉ định tùy thuộc vào phương thức 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 startAt()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ả phù hợ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ả:

Java

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

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

Kotlin + KTX

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

Giới hạn số lượng kết quả

Bạn có thể sử dụng các phương thức limitToFirst()limitToLast() để đặt số lượng con tối đa đượ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 giới hạn giới hạn limitToFirst() để đặt giới hạn 100, ban đầu bạn chỉ nhận được tối đa 100 cuộc 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 của mình, onChildAdded() gọi lại onChildAdded() kích hoạt cho từng mục.

Khi các mục thay đổi, bạn sẽ nhận được onChildAdded() gọi lại onChildAdded() cho các mục nhập truy vấn và onChildRemoved() gọi lại onChildRemoved() cho các mục bỏ ra khỏi mục đó để tổng số vẫn ở mức 100.

Ví dụ sau minh họa cách ứng dụng viết blog mẫu xác định 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:

Java

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

Kotlin + KTX

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

Ví dụ này chỉ định nghĩa một truy vấn, để thực sự đồng bộ hóa dữ liệu, nó cần phải có một trình nghe kèm theo.

Lọc theo khóa hoặc giá trị

Bạn có thể sử dụng startAt() , endAt()equalTo() để chọn các điểm bắt đầu, kết thúc và điểm tương đương tùy ý 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ó con 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 dữ liệu được sắp xếp theo từng phương thức theo thứ tự trong lớp Query .

orderByChild

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

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

orderByKey

Khi sử dụng orderByKey() để sắp xếp dữ liệu của bạn, dữ liệu được trả về theo thứ tự tăng dần theo từng 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 trước, được sắp xếp theo thứ tự tăng dần.
  2. Trẻ em với giá trị chuỗi là khóa tiếp theo, được sắp xếp theo từ vựng theo thứ tự tăng dần.

orderByValue

Khi sử dụng orderByValue() , trẻ em được sắp xếp theo giá trị của chúng. Các tiêu chí đặt hàng giống như trong orderByChild() , ngoại trừ giá trị của nút được sử dụng thay vì giá trị của khóa con được chỉ định.

Bước tiếp theo