Bật khả năng ngoại tuyến trên Android

Hành vi dai dẳng

Bằng cách kích hoạt tính bền bỉ, mọi dữ liệu mà ứng dụng khách Cơ sở dữ liệu thời gian thực Firebase sẽ đồng bộ hóa khi trực tuyến vẫn tồn tại trên đĩa và khả dụng ngoại tuyến, ngay cả khi người dùng hoặc hệ điều hành khởi động lại ứng dụng. Điều này có nghĩa là ứng dụng của bạn hoạt động như trực tuyến bằng cách sử dụng dữ liệu cục bộ được lưu trữ trong bộ đệm. Các cuộc gọi lại của người nghe sẽ tiếp tục kích hoạt các bản cập nhật cục bộ.

Ứng dụng khách Cơ sở dữ liệu thời gian thực Firebase tự động giữ một hàng đợi gồm tất cả các thao tác ghi được thực hiện khi ứng dụng của bạn ngoại tuyến. Khi tính năng kiên trì được bật, hàng đợi này cũng được lưu vào đĩa để tất cả các thao tác ghi của bạn đều khả dụng khi người dùng hoặc hệ điều hành khởi động lại ứng dụng. Khi ứng dụng lấy lại kết nối, tất cả các hoạt động được gửi đến máy chủ Cơ sở dữ liệu thời gian thực Firebase.

Nếu ứng dụng của bạn sử dụng Xác thực Firebase , ứng dụng Cơ sở dữ liệu thời gian thực Firebase sẽ duy trì mã thông báo xác thực của người dùng trong các lần khởi động lại ứng dụng. Nếu mã thông báo xác thực hết hạn trong khi ứng dụng của bạn ngoại tuyến, ứng dụng khách sẽ tạm dừng thao tác ghi cho đến khi ứng dụng của bạn xác thực lại người dùng, nếu không, thao tác ghi có thể không thành công do các quy tắc bảo mật.

Giữ dữ liệu mới

Cơ sở dữ liệu thời gian thực Firebase đồng bộ hóa và lưu trữ bản sao dữ liệu cục bộ cho người nghe đang hoạt động. Ngoài ra, bạn có thể đồng bộ hóa các vị trí cụ thể.

val scoresRef = Firebase.database.getReference("scores")
scoresRef.keepSynced(true)
OfflineActivity.kt

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores");
scoresRef.keepSynced(true);
OfflineActivity.java

Ứng dụng khách Cơ sở dữ liệu thời gian thực Firebase tự động tải xuống dữ liệu tại các vị trí này và giữ cho dữ liệu được đồng bộ hóa ngay cả khi tham chiếu không có trình lắng nghe đang hoạt động. Bạn có thể tắt đồng bộ hóa trở lại bằng dòng mã sau.

scoresRef.keepSynced(false)
OfflineActivity.kt

scoresRef.keepSynced(false);
OfflineActivity.java

Theo mặc định, 10 MB dữ liệu đã đồng bộ hóa trước đó được lưu vào bộ đệm ẩn. Điều này là đủ cho hầu hết các ứng dụng. Nếu bộ đệm vượt quá kích thước đã định cấu hình của nó, thì Cơ sở dữ liệu thời gian thực Firebase sẽ xóa dữ liệu ít được sử dụng gần đây nhất. Dữ liệu được đồng bộ hóa sẽ không bị xóa khỏi bộ đệm ẩn.

Truy vấn dữ liệu ngoại tuyến

Cơ sở dữ liệu thời gian thực Firebase lưu trữ dữ liệu được trả về từ truy vấn để sử dụng khi ngoại tuyến. Đối với các truy vấn được tạo khi ngoại tuyến, Cơ sở dữ liệu thời gian thực Firebase tiếp tục hoạt động đối với dữ liệu đã tải trước đó. Nếu dữ liệu được yêu cầu chưa được tải, thì Cơ sở dữ liệu thời gian thực Firebase sẽ tải dữ liệu từ bộ đệm cục bộ. Khi có kết nối mạng trở lại, dữ liệu sẽ tải và sẽ phản ánh truy vấn.

Ví dụ: mã này truy vấn bốn mục cuối cùng trong Cơ sở dữ liệu thời gian thực của Firebase về điểm số

val scoresRef = Firebase.database.getReference("scores")
scoresRef.orderByValue().limitToLast(4).addChildEventListener(object : ChildEventListener {
    override fun onChildAdded(snapshot: DataSnapshot, previousChild: String?) {
        Log.d(TAG, "The ${snapshot.key} dinosaur's score is ${snapshot.value}")
    }

    // ...
})
OfflineActivity.kt

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores");
scoresRef.orderByValue().limitToLast(4).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(@NonNull DataSnapshot snapshot, String previousChild) {
        Log.d(TAG, "The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }

    // ...
});
OfflineActivity.java

Giả sử rằng người dùng mất kết nối, ngoại tuyến và khởi động lại ứng dụng. Trong khi vẫn ngoại tuyến, ứng dụng sẽ truy vấn hai mục cuối cùng từ cùng một vị trí. Truy vấn này sẽ trả về thành công hai mục cuối cùng vì ứng dụng đã tải tất cả bốn mục trong truy vấn ở trên.

scoresRef.orderByValue().limitToLast(2).addChildEventListener(object : ChildEventListener {
    override fun onChildAdded(snapshot: DataSnapshot, previousChild: String?) {
        Log.d(TAG, "The ${snapshot.key} dinosaur's score is ${snapshot.value}")
    }

    // ...
})
OfflineActivity.kt

scoresRef.orderByValue().limitToLast(2).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(@NonNull DataSnapshot snapshot, String previousChild) {
        Log.d(TAG, "The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }

    // ...
});
OfflineActivity.java

Trong ví dụ trước, ứng dụng khách Cơ sở dữ liệu thời gian thực Firebase tăng các sự kiện 'thêm con' cho hai con khủng long có điểm số cao nhất, bằng cách sử dụng bộ nhớ đệm lâu dài. Nhưng nó sẽ không tăng sự kiện 'giá trị' vì ứng dụng chưa bao giờ thực hiện truy vấn đó khi trực tuyến.

Nếu ứng dụng yêu cầu sáu mục cuối cùng khi ngoại tuyến, thì ứng dụng sẽ nhận ngay các sự kiện 'thêm con' cho bốn mục được lưu trong bộ nhớ cache. Khi thiết bị trực tuyến trở lại, ứng dụng Cơ sở dữ liệu thời gian thực Firebase sẽ đồng bộ hóa với máy chủ và nhận hai sự kiện "thêm con" và "giá trị" cuối cùng cho ứng dụng.

Xử lý giao dịch ngoại tuyến

Bất kỳ giao dịch nào được thực hiện khi ứng dụng ngoại tuyến đều được xếp hàng đợi. Sau khi ứng dụng lấy lại kết nối mạng, các giao dịch sẽ được gửi đến máy chủ Cơ sở dữ liệu thời gian thực.

Cách thức hoạt động của Ngắt kết nối

Khi bạn thiết lập một thao tác onDisconnect() , thao tác này sẽ tồn tại trên máy chủ Cơ sở dữ liệu thời gian thực Firebase. Máy chủ kiểm tra bảo mật để đảm bảo người dùng có thể thực hiện sự kiện ghi được yêu cầu và thông báo cho ứng dụng của bạn nếu nó không hợp lệ. Máy chủ sau đó giám sát kết nối. Nếu tại bất kỳ thời điểm nào, kết nối hết thời gian hoặc bị máy khách Cơ sở dữ liệu thời gian thực chủ động đóng, máy chủ sẽ kiểm tra bảo mật lần thứ hai (để đảm bảo hoạt động vẫn hợp lệ) rồi gọi sự kiện.

Ứng dụng của bạn có thể sử dụng lệnh gọi lại trong thao tác ghi để đảm bảo onDisconnect được đính kèm chính xác:

presenceRef.onDisconnect().removeValue { error, reference ->
    error?.let {
        Log.d(TAG, "could not establish onDisconnect event: ${error.message}")
    }
}
OfflineActivity.kt

presenceRef.onDisconnect().removeValue(new DatabaseReference.CompletionListener() {
    @Override
    public void onComplete(DatabaseError error, @NonNull DatabaseReference reference) {
        if (error != null) {
            Log.d(TAG, "could not establish onDisconnect event:" + error.getMessage());
        }
    }
});
OfflineActivity.java

Một sự kiện onDisconnect cũng có thể bị hủy bằng cách gọi .cancel() :

val onDisconnectRef = presenceRef.onDisconnect()
onDisconnectRef.setValue("I disconnected")
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel()
OfflineActivity.kt

OnDisconnect onDisconnectRef = presenceRef.onDisconnect();
onDisconnectRef.setValue("I disconnected");
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel();
OfflineActivity.java

Dấu thời gian máy chủ

Máy chủ Cơ sở dữ liệu thời gian thực Firebase cung cấp cơ chế để chèn dấu thời gian được tạo trên máy chủ dưới dạng dữ liệu. Tính năng này, được kết hợp với onDisconnect , cung cấp một cách dễ dàng để ghi lại thời gian mà máy khách Cơ sở dữ liệu thời gian thực bị ngắt kết nối:

val userLastOnlineRef = Firebase.database.getReference("users/joe/lastOnline")
userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP)
OfflineActivity.kt

DatabaseReference userLastOnlineRef = FirebaseDatabase.getInstance().getReference("users/joe/lastOnline");
userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP);
OfflineActivity.java

Đồng hồ nghiêng

Mặc dù firebase.database.ServerValue.TIMESTAMP chính xác hơn nhiều và thích hợp hơn cho hầu hết các hoạt động đọc/ghi, đôi khi có thể hữu ích khi ước tính độ lệch đồng hồ của máy khách so với máy chủ của Cơ sở dữ liệu thời gian thực Firebase. Bạn có thể đính kèm lệnh gọi lại vào vị trí /.info/serverTimeOffset để nhận giá trị tính bằng mili giây mà ứng dụng khách Cơ sở dữ liệu thời gian thực Firebase thêm vào thời gian được báo cáo cục bộ (thời gian epoch tính bằng mili giây) để ước tính thời gian của máy chủ. Lưu ý rằng độ chính xác của phần bù này có thể bị ảnh hưởng bởi độ trễ của mạng và do đó, tính năng này chủ yếu hữu ích để khám phá các chênh lệch lớn (> 1 giây) trong thời gian đồng hồ.

val offsetRef = Firebase.database.getReference(".info/serverTimeOffset")
offsetRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
        val offset = snapshot.getValue(Double::class.java) ?: 0.0
        val estimatedServerTimeMs = System.currentTimeMillis() + offset
    }

    override fun onCancelled(error: DatabaseError) {
        Log.w(TAG, "Listener was cancelled")
    }
})
OfflineActivity.kt

DatabaseReference offsetRef = FirebaseDatabase.getInstance().getReference(".info/serverTimeOffset");
offsetRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        double offset = snapshot.getValue(Double.class);
        double estimatedServerTimeMs = System.currentTimeMillis() + offset;
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Log.w(TAG, "Listener was cancelled");
    }
});
OfflineActivity.java