Firebase uygulamaları, uygulamanızın ağ bağlantısı geçici olarak kesilse bile çalışır. Ayrıca Firebase, verileri yerel olarak kalıcı hale getirme, varlığı yönetme ve gecikmeyi işleme araçları da sağlar.
Disk Kalıcılığı
Firebase uygulamaları, geçici ağ kesintilerini otomatik olarak işler. Önbelleğe alınan veriler çevrimdışıyken kullanılabilir. Ağ bağlantısı geri geldiğinde Firebase, tüm yazma işlemlerini yeniden gönderir.
Disk kalıcılığını etkinleştirdiğinizde uygulamanız, verileri yerel olarak cihaza yazar. Böylece, kullanıcı veya işletim sistemi uygulamayı yeniden başlatsa bile uygulamanız çevrimdışı durumdayken durumu koruyabilir.
Yalnızca tek bir kod satırıyla disk kalıcılığını etkinleştirebilirsiniz.
FirebaseDatabase.instance.setPersistenceEnabled(true);
Kalıcılık Davranışı
Kalıcılığı etkinleştirdiğinizde, Firebase Realtime Database istemcisinin çevrimiçiyken senkronize edeceği tüm veriler diske kaydedilir ve kullanıcı veya işletim sistemi uygulamayı yeniden başlatsa bile çevrimdışı olarak kullanılabilir. Bu sayede uygulamanız, önbellekte depolanan yerel verileri kullanarak çevrimiçindeymiş gibi çalışır. Dinleyici geri çağırmaları, yerel güncellemeler için tetiklenmeye devam eder.
Firebase Realtime Database istemcisi, uygulamanız çevrimdışıyken gerçekleştirilen tüm yazma işlemlerinin sırasını otomatik olarak tutar. Kalıcılık etkinleştirildiğinde bu sıra da diske kalıcı olarak kaydedilir. Böylece, kullanıcı veya işletim sistemi uygulamayı yeniden başlattığında tüm yazma işlemleriniz kullanılabilir. Uygulama bağlantıyı tekrar kazandığında tüm işlemler Firebase Realtime Database sunucusuna gönderilir.
Uygulamanız Firebase Authentication kullanıyorsa Firebase Realtime Database istemcisi, kullanıcının kimlik doğrulama jetonunu uygulama yeniden başlatıldığında da saklar. Uygulamanız çevrimdışı durumdayken kimlik doğrulama jetonunun süresi dolarsa istemci, uygulamanız kullanıcıyı yeniden doğrulayana kadar yazma işlemlerini duraklatır. Aksi takdirde, güvenlik kuralları nedeniyle yazma işlemleri başarısız olabilir.
Verileri güncel tutma
Firebase Realtime Database, etkin dinleyiciler için verilerin yerel bir kopyasını senkronize eder ve depolar. Ayrıca belirli konumları senkronize edebilirsiniz.
final scoresRef = FirebaseDatabase.instance.ref("scores");
scoresRef.keepSynced(true);
Firebase Realtime Database istemcisi, bu konumlardaki verileri otomatik olarak indirir ve referansta etkin dinleyici olmasa bile senkronize tutar. Aşağıdaki kod satırıyla senkronizasyonu tekrar kapatabilirsiniz.
scoresRef.keepSynced(false);
Varsayılan olarak, daha önce senkronize edilmiş 10 MB'lık veri önbelleğe alınır. Bu, çoğu uygulama için yeterli olmalıdır. Önbellek, yapılandırılmış boyutunu aşarsa Firebase Realtime Database, en son kullanılmayan verileri temizler. Senkronize edilen veriler önbellekten temizlenmez.
Verileri Çevrimdışı Sorgulama
Firebase Realtime Database, çevrimdışıyken kullanılmak üzere bir sorgudan döndürülen verileri depolar. Çevrimdışıyken oluşturulan sorgular için, Firebase Realtime Database önceden yüklenen verilerle çalışmaya devam eder. İstenen veriler yüklenmediyse Firebase Realtime Database, verileri yerel önbellekten yükler. Ağ bağlantısı tekrar kullanılabilir olduğunda, veriler yüklenir ve sorguyu yansıtır.
Örneğin, bu kod, puan veritabanındaki son dört öğeyi sorgular:
final scoresRef = FirebaseDatabase.instance.ref("scores");
scoresRef.orderByValue().limitToLast(4).onChildAdded.listen((event) {
debugPrint("The ${event.snapshot.key} dinosaur's score is ${event.snapshot.value}.");
});
Kullanıcının bağlantıyı kaybettiğini, çevrimdışı kaldığını ve uygulamayı yeniden başlattığını varsayalım. Uygulama, hâlâ çevrimdışı durumdayken aynı konumdaki son iki öğeyi sorgular. Bu sorgu, yukarıdaki sorguda uygulamanın dört öğeyi de yüklemiş olması nedeniyle son iki öğeyi başarıyla döndürür.
scoresRef.orderByValue().limitToLast(2).onChildAdded.listen((event) {
debugPrint("The ${event.snapshot.key} dinosaur's score is ${event.snapshot.value}.");
});
Önceki örnekte, Firebase Realtime Database istemcisi, kalıcı önbelleği kullanarak en yüksek puanlı iki dinozor için "child added" etkinliklerini tetikler. Ancak uygulama, internete bağlıyken bu sorguyu hiç yürütmediği için "değer" etkinliği oluşturmaz.
Uygulama, çevrimdışı durumdayken son altı öğeyi isterse önbelleğe alınan dört öğe için hemen "alt öğe eklendi" etkinliklerini alır. Cihaz tekrar internete bağlandığında Firebase Realtime Database istemcisi sunucuyla senkronize olur ve uygulama için son iki "child_added" ve "value" etkinliklerini alır.
İşlemleri Çevrimdışı Olarak İşleme
Uygulama çevrimdışıyken gerçekleştirilen tüm işlemler sıraya alınır. Uygulama ağ bağlantısını yeniden sağladığında işlemler Realtime Database sunucusuna gönderilir.
Firebase Realtime Database, çevrimdışı senaryolar ve ağ bağlantısıyla ilgili birçok özelliğe sahiptir. Bu kılavuzun geri kalanı, kalıcılığı etkinleştirip etkinleştirmediğinizden bağımsız olarak uygulamanız için geçerlidir.
Varlığı Yönetme
Gerçek zamanlı uygulamalarda, istemcilerin ne zaman bağlandığını ve bağlantısının kesildiğini algılamak genellikle yararlıdır. Örneğin, istemcisinin bağlantısı kesilen bir kullanıcıyı "çevrimdışı" olarak işaretlemek isteyebilirsiniz.
Firebase Database istemcileri, bir istemci Firebase Database sunucularının bağlantısını kestiğinde veritabanına yazmak için kullanabileceğiniz basit temel öğeler sağlar. Bu güncellemeler, istemcinin bağlantısı düzgün bir şekilde kesilse de kesilmese de gerçekleşir. Bu nedenle, bağlantı düşse veya istemci kilitlense bile verileri temizlemek için bu güncellemelerden yararlanabilirsiniz. Ayar yapma, güncelleme ve kaldırma dahil olmak üzere tüm yazma işlemleri bağlantı kesildiğinde gerçekleştirilebilir.
onDisconnect temel öğesini kullanarak bağlantı kesildiğinde veri yazma işleminin basit bir örneğini aşağıda bulabilirsiniz:
final presenceRef = FirebaseDatabase.instance.ref("disconnectmessage");
// Write a string when this client loses connection
presenceRef.onDisconnect().set("I disconnected!");
onDisconnect'in işleyiş şekli
Bir onDisconnect() işlemi oluşturduğunuzda işlem, Firebase Realtime Database sunucusunda yer alır. Sunucu, kullanıcının istenen yazma etkinliğini gerçekleştirebildiğinden emin olmak için güvenliği kontrol eder ve geçersizse uygulamanızı bilgilendirir. Sunucu daha sonra bağlantıyı izler. Bağlantının herhangi bir noktada zaman aşımına uğraması veya Realtime Database istemcisi tarafından etkin olarak kapatılması durumunda sunucu, işlemi ikinci kez kontrol eder (işlemin hâlâ geçerli olduğundan emin olmak için) ve ardından etkinliği çağırır.
try {
await presenceRef.onDisconnect().remove();
} catch (error) {
debugPrint("Could not establish onDisconnect event: $error");
}
Bir onDisconnect etkinliği, .cancel() çağrılarak da iptal edilebilir:
final onDisconnectRef = presenceRef.onDisconnect();
onDisconnectRef.set("I disconnected");
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel();
Bağlantı durumunu algılama
Birçok varlık özelliği için uygulamanızın internete bağlı veya bağlı olmadığı zamanları bilmesi faydalıdır. Firebase Realtime Database, /.info/connected konumunda özel bir yer sağlar. Bu konum, Firebase Realtime Database istemcisinin bağlantı durumu her değiştiğinde güncellenir. Örnek:
final connectedRef = FirebaseDatabase.instance.ref(".info/connected");
connectedRef.onValue.listen((event) {
final connected = event.snapshot.value as bool? ?? false;
if (connected) {
debugPrint("Connected.");
} else {
debugPrint("Not connected.");
}
});
/.info/connected, istemcinin durumuna bağlı olduğu için Realtime Database istemcileri arasında senkronize edilmeyen bir Boole değeridir. Başka bir deyişle, bir istemci /.info/connected değerini yanlış olarak okursa ayrı bir istemcinin de yanlış olarak okuyacağı garanti edilmez.
İşleme Gecikmesi
Sunucu Zaman Damgaları
Firebase Realtime Database sunucuları, sunucuda oluşturulan zaman damgalarını veri olarak eklemek için bir mekanizma sağlar. Bu özellik, onDisconnect ile birlikte kullanıldığında Realtime Database istemcisinin bağlantısının kesildiği zamanı güvenilir bir şekilde not almanın kolay bir yolunu sunar:
final userLastOnlineRef =
FirebaseDatabase.instance.ref("users/joe/lastOnline");
userLastOnlineRef.onDisconnect().set(ServerValue.timestamp);
Saat Sapması
ServerValue.timestamp çok daha doğru olsa ve çoğu okuma/yazma işlemi için tercih edilse de bazen istemcinin saat sapmasını Firebase Realtime Database'in sunucularına göre tahmin etmek yararlı olabilir. Firebase Realtime Database istemcilerinin sunucu saatini tahmin etmek için yerel olarak bildirilen saate (milisaniye cinsinden dönem zamanı) eklediği değeri milisaniye cinsinden almak üzere konuma bir geri çağırma işlevi ekleyebilirsiniz /.info/serverTimeOffset. Bu farkın doğruluğunun ağ gecikmesinden etkilenebileceğini ve bu nedenle öncelikle saat zamanındaki büyük (> 1 saniye) tutarsızlıkları keşfetmek için yararlı olduğunu unutmayın.
final offsetRef = FirebaseDatabase.instance.ref(".info/serverTimeOffset");
offsetRef.onValue.listen((event) {
final offset = event.snapshot.value as num? ?? 0.0;
final estimatedServerTimeMs =
DateTime.now().millisecondsSinceEpoch + offset;
});
Örnek Presence Uygulaması
Bağlantıyı kesme işlemlerini bağlantı durumu izleme ve sunucu zaman damgalarıyla birleştirerek kullanıcı varlığı sistemi oluşturabilirsiniz. Bu sistemde her kullanıcı, bir Realtime Database istemcisinin çevrimiçi olup olmadığını belirtmek için verileri bir veritabanı konumunda depolar. İstemciler, internete bağlandıklarında bu konumu doğru, bağlantıyı kestiklerinde ise zaman damgası olarak ayarlar. Bu zaman damgası, söz konusu kullanıcının en son ne zaman çevrimiçi olduğunu gösterir.
İstemcinin ağ bağlantısı her iki komut da sunucuya gönderilmeden önce kaybolursa yarış durumu oluşmasını önlemek için uygulamanızın, kullanıcı çevrimiçi olarak işaretlenmeden önce bağlantıyı kesme işlemlerini sıraya alması gerektiğini unutmayın.
// Since I can connect from multiple devices, we store each connection
// instance separately any time that connectionsRef's value is null (i.e.
// has no children) I am offline.
final myConnectionsRef =
FirebaseDatabase.instance.ref("users/joe/connections");
// Stores the timestamp of my last disconnect (the last time I was seen online)
final lastOnlineRef =
FirebaseDatabase.instance.ref("/users/joe/lastOnline");
final connectedRef = FirebaseDatabase.instance.ref(".info/connected");
connectedRef.onValue.listen((event) {
final connected = event.snapshot.value as bool? ?? false;
if (connected) {
final con = myConnectionsRef.push();
// When this device disconnects, remove it.
con.onDisconnect().remove();
// When I disconnect, update the last time I was seen online.
lastOnlineRef.onDisconnect().set(ServerValue.timestamp);
// Add this device to my connections list.
// This value could contain info about the device or a timestamp too.
con.set(true);
}
});