Query
sắp xếp và lọc dữ liệu tại vị trí Cơ sở dữ liệu để chỉ đưa vào một nhóm nhỏ dữ liệu con. Bạn có thể dùng tính năng này để sắp xếp một tập hợp dữ liệu theo một số thuộc tính (ví dụ: chiều cao của khủng long) cũng như để hạn chế một danh sách gồm số lượng lớn các mục (ví dụ: tin nhắn trò chuyện) xuống một số lượng phù hợp để đồng bộ hoá với ứng dụng. Các truy vấn được tạo bằng cách xâu chuỗi một hoặc nhiều phương thức lọc được xác định tại đây.
Tương tự như với DatabaseReference
, bạn có thể nhận dữ liệu từ Query
bằng cách sử dụng các phương thức on*()
. Bạn sẽ chỉ nhận được các sự kiện và DataSnapshot
cho nhóm nhỏ dữ liệu khớp với truy vấn của bạn.
Hãy tham khảo https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data để biết thêm thông tin.
Chữ ký:
export declare interface Query
Thuộc tính
Tài sản | Loại | Mô tả |
---|---|---|
tham chiếu | DatabaseReference (Tham chiếu cơ sở dữ liệu) | DatabaseReference cho vị trí của Query . |
Phương thức
Phương thức | Mô tả |
---|---|
isEqual(other) | Trả về cho biết truy vấn hiện tại và truy vấn đã cung cấp có đại diện cho cùng một vị trí, có cùng tham số truy vấn và đến từ cùng một phiên bản FirebaseApp hay không.Hai đối tượng DatabaseReference là tương đương nếu chúng đại diện cho cùng một vị trí và đến từ cùng một thực thể của FirebaseApp .Hai đối tượng Query tương đương nhau nếu chúng đại diện cho cùng một vị trí, có cùng tham số truy vấn và đến từ cùng một phiên bản FirebaseApp . Các truy vấn tương đương có cùng thứ tự sắp xếp, giới hạn, điểm bắt đầu và điểm kết thúc. |
toJSON() | Trả về một bản trình bày có thể chuyển đổi tuần tự JSON của đối tượng này. |
toString() | Lấy URL tuyệt đối cho vị trí này.Phương thức toString() trả về một URL có thể đưa vào trình duyệt, lệnh curl hoặc lệnh gọi refFromURL() . Vì tất cả những người dùng đó đều muốn URL được mã hoá URL, nên toString() sẽ trả về một URL được mã hoá.Thêm ".json" vào URL được trả về khi nhập vào trình duyệt để tải dữ liệu có định dạng JSON xuống. Nếu thông tin vị trí đó được bảo mật (tức là không thể đọc được công khai), bạn sẽ gặp lỗi bị từ chối cấp quyền. |
Truy vấn.ref
DatabaseReference
cho vị trí của Query
.
Chữ ký:
readonly ref: DatabaseReference;
Truy vấn.isEqual()
Trả về liệu các truy vấn hiện tại và truy vấn đã cung cấp có đại diện cho cùng một vị trí, có cùng tham số truy vấn và đến từ cùng một thực thể của FirebaseApp
hay không.
2 đối tượng DatabaseReference
tương đương nhau nếu chúng đại diện cho cùng một vị trí và thuộc cùng một thực thể của FirebaseApp
.
Hai đối tượng Query
tương đương nhau nếu chúng đại diện cho cùng một vị trí, có cùng tham số truy vấn và thuộc cùng một thực thể của FirebaseApp
. Các truy vấn tương đương có cùng thứ tự sắp xếp, giới hạn, điểm bắt đầu và điểm kết thúc.
Chữ ký:
isEqual(other: Query | null): boolean;
Thông số
Thông số | Loại | Mô tả |
---|---|---|
khác | Cụm từ tìm kiếm | rỗng | Cụm từ tìm kiếm để so sánh. |
Trường hợp trả lại hàng:
boolean
Liệu các cụm từ tìm kiếm hiện tại và các cụm từ tìm kiếm đã cung cấp có tương đương hay không.
Query.toJSON()
Trả về một bản trình bày có thể chuyển đổi tuần tự JSON của đối tượng này.
Chữ ký:
toJSON(): string;
Trường hợp trả lại hàng:
chuỗi
Một bản trình bày có thể chuyển đổi tuần tự JSON của đối tượng này.
Query.toString()
Lấy URL tuyệt đối cho vị trí này.
Phương thức toString()
trả về một URL đã sẵn sàng để đưa vào trình duyệt, lệnh curl hoặc lệnh gọi refFromURL()
. Vì tất cả người dùng trong số đó đều muốn URL được mã hoá URL, nên toString()
sẽ trả về một URL được mã hoá.
Thêm ".json" vào URL được trả về khi nhập vào trình duyệt để tải dữ liệu có định dạng JSON xuống. Nếu thông tin vị trí đó được bảo mật (tức là không thể đọc được công khai), bạn sẽ gặp lỗi bị từ chối cấp quyền.
Chữ ký:
toString(): string;
Trường hợp trả lại hàng:
chuỗi
URL tuyệt đối cho vị trí này.