अगर आपके ऐप्लिकेशन का नेटवर्क कनेक्शन कुछ समय के लिए बंद हो जाता है, तब भी Firebase ऐप्लिकेशन काम करते हैं. इसके अलावा, Firebase डेटा को स्थानीय तौर पर सेव करने, मौजूदगी को मैनेज करने, और लेटेन्सी को हैंडल करने के लिए टूल उपलब्ध कराता है.
डिस्क पर्सिस्टेंस
Firebase ऐप्लिकेशन, नेटवर्क में कुछ समय के लिए आने वाली रुकावटों को अपने-आप ठीक कर लेते हैं. कैश किया गया डेटा ऑफ़लाइन होने पर भी उपलब्ध होता है. साथ ही, नेटवर्क कनेक्शन बहाल होने पर Firebase, सभी राइट ऑपरेशन को फिर से भेजता है.
डिस्क पर डेटा सेव करने की सुविधा चालू करने पर, आपका ऐप्लिकेशन डेटा को डिवाइस पर सेव करता है. इससे, ऐप्लिकेशन ऑफ़लाइन होने पर भी अपनी स्थिति बनाए रख सकता है. भले ही, उपयोगकर्ता या ऑपरेटिंग सिस्टम ऐप्लिकेशन को फिर से चालू करे.
सिर्फ़ एक लाइन के कोड से, डिस्क पर डेटा सेव करने की सुविधा चालू की जा सकती है.
Swift
Database.database().isPersistenceEnabled = true
Objective-C
[FIRDatabase database].persistenceEnabled = YES;
स्थायित्व का व्यवहार
परसिस्टेंस की सुविधा चालू करने पर, Firebase Realtime Database क्लाइंट ऑनलाइन होने पर जो भी डेटा सिंक करता है वह डिस्क पर सेव रहता है. साथ ही, यह डेटा ऑफ़लाइन होने पर भी उपलब्ध रहता है. ऐसा तब भी होता है, जब उपयोगकर्ता या ऑपरेटिंग सिस्टम ऐप्लिकेशन को रीस्टार्ट करता है. इसका मतलब है कि आपका ऐप्लिकेशन, कैश मेमोरी में सेव किए गए स्थानीय डेटा का इस्तेमाल करके, ऑनलाइन की तरह ही काम करता है. लोकल अपडेट के लिए, लिसनर कॉलबैक ट्रिगर होते रहेंगे.
Firebase Realtime Database क्लाइंट, आपके ऐप्लिकेशन के ऑफ़लाइन होने पर किए गए सभी राइट ऑपरेशन की एक सूची अपने-आप बना लेता है. डेटा को सेव करने की सुविधा चालू होने पर, इस कतार को डिस्क में भी सेव किया जाता है. इससे, जब उपयोगकर्ता या ऑपरेटिंग सिस्टम ऐप्लिकेशन को फिर से चालू करता है, तब आपके सभी लिखे गए डेटा को ऐक्सेस किया जा सकता है. जब ऐप्लिकेशन फिर से कनेक्ट हो जाता है, तब सभी कार्रवाइयां Firebase Realtime Database सर्वर को भेज दी जाती हैं.
अगर आपका ऐप्लिकेशन Firebase Authentication का इस्तेमाल करता है, तो Firebase Realtime Database क्लाइंट, ऐप्लिकेशन को फिर से चालू करने पर भी उपयोगकर्ता के पुष्टि करने वाले टोकन को सेव रखता है. अगर आपका ऐप्लिकेशन ऑफ़लाइन होने के दौरान पुष्टि करने वाले टोकन की समयसीमा खत्म हो जाती है, तो क्लाइंट, लिखने की कार्रवाइयों को तब तक रोक देता है, जब तक आपका ऐप्लिकेशन उपयोगकर्ता की फिर से पुष्टि नहीं कर लेता. ऐसा न होने पर, सुरक्षा नियमों की वजह से लिखने की कार्रवाइयां पूरी नहीं हो सकती हैं.
डेटा को अप-टू-डेट रखना
Firebase Realtime Database, चालू श्रोताओं के लिए डेटा की एक लोकल कॉपी को सिंक और सेव करता है. इसके अलावा, कुछ जगहों को सिंक किया जा सकता है.
Swift
let scoresRef = Database.database().reference(withPath: "scores") scoresRef.keepSynced(true)
Objective-C
FIRDatabaseReference *scoresRef = [[FIRDatabase database] referenceWithPath:@"scores"]; [scoresRef keepSynced:YES];
Firebase Realtime Database क्लाइंट, इन जगहों पर मौजूद डेटा को अपने-आप डाउनलोड कर लेता है. साथ ही, इसे सिंक रखता है. भले ही, रेफ़रंस में कोई चालू लिसनर न हो. सिंक्रनाइज़ेशन की सुविधा को फिर से बंद करने के लिए, कोड की इस लाइन का इस्तेमाल करें.
Swift
scoresRef.keepSynced(false)
Objective-C
[scoresRef keepSynced:NO];
डिफ़ॉल्ट रूप से, पहले सिंक किए गए 10 एमबी डेटा को कैश मेमोरी में सेव किया जाता है. यह ज़्यादातर ऐप्लिकेशन के लिए काफ़ी होना चाहिए. अगर कैश मेमोरी का साइज़, कॉन्फ़िगर किए गए साइज़ से ज़्यादा हो जाता है, तो Firebase Realtime Database उस डेटा को मिटा देता है जिसका इस्तेमाल हाल ही में सबसे कम किया गया है. सिंक किए गए डेटा को कैश मेमोरी से नहीं हटाया जाता.
ऑफ़लाइन डेटा को क्वेरी करना
Firebase Realtime Database, क्वेरी से मिले डेटा को सेव करता है, ताकि ऑफ़लाइन होने पर उसका इस्तेमाल किया जा सके. ऑफ़लाइन होने पर बनाई गई क्वेरी के लिए, Firebase Realtime Database पहले से लोड किए गए डेटा के लिए काम करता रहता है. अगर अनुरोध किया गया डेटा लोड नहीं हुआ है, तो Firebase Realtime Database लोकल कैश मेमोरी से डेटा लोड करता है. नेटवर्क कनेक्टिविटी फिर से उपलब्ध होने पर, डेटा लोड हो जाता है और क्वेरी दिखने लगती है.
उदाहरण के लिए, यह कोड स्कोर की Firebase Realtime Database में मौजूद आखिरी चार आइटम के लिए क्वेरी करता है
Swift
let scoresRef = Database.database().reference(withPath: "scores") scoresRef.queryOrderedByValue().queryLimited(toLast: 4).observe(.childAdded) { snapshot in print("The \(snapshot.key) dinosaur's score is \(snapshot.value ?? "null")") }
Objective-C
FIRDatabaseReference *scoresRef = [[FIRDatabase database] referenceWithPath:@"scores"]; [[[scoresRef queryOrderedByValue] queryLimitedToLast:4] observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) { NSLog(@"The %@ dinosaur's score is %@", snapshot.key, snapshot.value); }];
मान लें कि उपयोगकर्ता का कनेक्शन बंद हो जाता है, वह ऑफ़लाइन हो जाता है, और ऐप्लिकेशन को फिर से चालू करता है. ऑफ़लाइन होने पर भी, ऐप्लिकेशन उसी जगह के पिछले दो आइटम के लिए क्वेरी करता है. इस क्वेरी से, आखिरी दो आइटम दिखेंगे. ऐसा इसलिए होगा, क्योंकि ऐप्लिकेशन ने ऊपर दी गई क्वेरी में मौजूद सभी चार आइटम लोड कर लिए थे.
Swift
scoresRef.queryOrderedByValue().queryLimited(toLast: 2).observe(.childAdded) { snapshot in print("The \(snapshot.key) dinosaur's score is \(snapshot.value ?? "null")") }
Objective-C
[[[scoresRef queryOrderedByValue] queryLimitedToLast:2] observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) { NSLog(@"The %@ dinosaur's score is %@", snapshot.key, snapshot.value); }];
ऊपर दिए गए उदाहरण में, Firebase Realtime Database क्लाइंट, सबसे ज़्यादा स्कोर वाले दो डायनासोर के लिए 'child added' इवेंट जनरेट करता है. इसके लिए, वह सेव की गई कैश मेमोरी का इस्तेमाल करता है. हालांकि, इससे 'value' इवेंट ट्रिगर नहीं होगा, क्योंकि ऐप्लिकेशन ने ऑनलाइन होने पर कभी भी उस क्वेरी को नहीं चलाया है.
अगर ऐप्लिकेशन ऑफ़लाइन होने पर पिछले छह आइटम का अनुरोध करता है, तो उसे कैश मेमोरी में सेव किए गए चार आइटम के लिए, 'बच्चा जोड़ा गया' इवेंट तुरंत मिल जाएंगे. जब डिवाइस वापस ऑनलाइन आता है, तब Firebase Realtime Database क्लाइंट, सर्वर के साथ सिंक हो जाता है. साथ ही, उसे ऐप्लिकेशन के लिए 'बच्चे को जोड़ा गया' और 'वैल्यू' इवेंट के दो फ़ाइनल इवेंट मिलते हैं.
ऑफ़लाइन लेन-देन मैनेज करना
ऐप्लिकेशन के ऑफ़लाइन होने पर किए गए सभी लेन-देन, लाइन में लग जाते हैं. ऐप्लिकेशन के फिर से इंटरनेट से कनेक्ट होने पर, लेन-देन की जानकारी Realtime Database सर्वर को भेज दी जाती है.
मौजूदगी मैनेज करना
रीयलटाइम ऐप्लिकेशन में, यह पता लगाना अक्सर काम का होता है कि क्लाइंट कब कनेक्ट और डिसकनेक्ट होते हैं. उदाहरण के लिए, जब किसी उपयोगकर्ता का क्लाइंट डिसकनेक्ट हो जाता है, तब हो सकता है कि आपको उसे 'ऑफ़लाइन' के तौर पर मार्क करना हो.
Firebase Database क्लाइंट, आसान प्रिमिटिव उपलब्ध कराते हैं. इनका इस्तेमाल, क्लाइंट के Firebase Database सर्वर से डिसकनेक्ट होने पर डेटाबेस में लिखने के लिए किया जा सकता है. ये अपडेट तब भी होते हैं, जब क्लाइंट ठीक से डिसकनेक्ट नहीं होता है. इसलिए, डेटा को साफ़ करने के लिए इन पर भरोसा किया जा सकता है. भले ही, कनेक्शन बंद हो गया हो या क्लाइंट क्रैश हो गया हो. कनेक्शन बंद होने पर, लिखने से जुड़ी सभी कार्रवाइयां की जा सकती हैं. जैसे, सेटिंग करना, अपडेट करना, और हटाना.
यहां onDisconnect प्रिमिटिव का इस्तेमाल करके, कनेक्शन बंद होने पर डेटा लिखने का एक सामान्य उदाहरण दिया गया है:
Swift
let presenceRef = Database.database().reference(withPath: "disconnectmessage"); // Write a string when this client loses connection presenceRef.onDisconnectSetValue("I disconnected!")
Objective-C
FIRDatabaseReference *presenceRef = [[FIRDatabase database] referenceWithPath:@"disconnectmessage"]; // Write a string when this client loses connection [presenceRef onDisconnectSetValue:@"I disconnected!"];
onDisconnect कैसे काम करता है
onDisconnect() ऑपरेशन सेट अप करने पर, यह Firebase Realtime Database सर्वर पर सेव हो जाता है. सर्वर, सुरक्षा की जांच करता है, ताकि यह पक्का किया जा सके कि उपयोगकर्ता, अनुरोध किया गया राइट इवेंट पूरा कर सकता है. अगर यह अमान्य है, तो सर्वर आपके ऐप्लिकेशन को इसकी सूचना देता है. इसके बाद, सर्वर कनेक्शन की निगरानी करता है. अगर किसी भी समय कनेक्शन टाइम आउट हो जाता है या Realtime Database क्लाइंट उसे बंद कर देता है, तो सर्वर दूसरी बार सुरक्षा की जांच करता है. इससे यह पक्का किया जाता है कि ऑपरेशन अब भी मान्य है. इसके बाद, सर्वर इवेंट को शुरू करता है.
आपका ऐप्लिकेशन, राइट ऑपरेशन पर कॉलबैक का इस्तेमाल कर सकता है. इससे यह पक्का किया जा सकता है कि onDisconnect सही तरीके से अटैच किया गया है:
Swift
presenceRef.onDisconnectRemoveValue { error, reference in
if let error = error {
print("Could not establish onDisconnect event: \(error)")
}
}Objective-C
[presenceRef onDisconnectRemoveValueWithCompletionBlock:^(NSError *error, FIRDatabaseReference *reference) { if (error != nil) { NSLog(@"Could not establish onDisconnect event: %@", error); } }];
.cancel() पर कॉल करके भी onDisconnect इवेंट को रद्द किया जा सकता है:
Swift
presenceRef.onDisconnectSetValue("I disconnected")
// some time later when we change our minds
presenceRef.cancelDisconnectOperations()Objective-C
[presenceRef onDisconnectSetValue:@"I disconnected"]; // some time later when we change our minds [presenceRef cancelDisconnectOperations];
कनेक्शन का स्टेटस पता लगाया जा रहा है
उपयोगकर्ता की मौजूदगी से जुड़ी कई सुविधाओं के लिए, आपके ऐप्लिकेशन को यह पता होना चाहिए कि वह ऑनलाइन है या ऑफ़लाइन. Firebase Realtime Database, /.info/connected पर एक खास जगह उपलब्ध कराता है. यह जगह, Firebase Realtime Database क्लाइंट के कनेक्शन की स्थिति में बदलाव होने पर हर बार अपडेट होती है. यहां एक उदाहरण दिया गया है:
Swift
let connectedRef = Database.database().reference(withPath: ".info/connected") connectedRef.observe(.value, with: { snapshot in if snapshot.value as? Bool ?? false { print("Connected") } else { print("Not connected") } })
Objective-C
FIRDatabaseReference *connectedRef = [[FIRDatabase database] referenceWithPath:@".info/connected"]; [connectedRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) { if([snapshot.value boolValue]) { NSLog(@"connected"); } else { NSLog(@"not connected"); } }];
/.info/connected एक बूलियन वैल्यू है. इसे Realtime Database क्लाइंट के बीच सिंक्रनाइज़ नहीं किया जाता, क्योंकि वैल्यू क्लाइंट की स्थिति पर निर्भर करती है. दूसरे शब्दों में कहें, तो अगर कोई क्लाइंट /.info/connected को 'गलत' के तौर पर पढ़ता है, तो इस बात की कोई गारंटी नहीं है कि कोई दूसरा क्लाइंट भी इसे 'गलत' के तौर पर पढ़ेगा.
हैंडलिंग में लगने वाला समय
सर्वर टाइमस्टैंप
Firebase Realtime Database सर्वर, सर्वर पर जनरेट किए गए टाइमस्टैंप को डेटा के तौर पर डालने का तरीका उपलब्ध कराते हैं. इस सुविधा के साथ-साथ onDisconnect का इस्तेमाल करके, Realtime Database क्लाइंट के डिसकनेक्ट होने के समय को आसानी से नोट किया जा सकता है:
Swift
let userLastOnlineRef = Database.database().reference(withPath: "users/morgan/lastOnline") userLastOnlineRef.onDisconnectSetValue(ServerValue.timestamp())
Objective-C
FIRDatabaseReference *userLastOnlineRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/lastOnline"]; [userLastOnlineRef onDisconnectSetValue:[FIRServerValue timestamp]];
क्लॉक स्क्यू
firebase.database.ServerValue.TIMESTAMP ज़्यादा सटीक है. साथ ही, पढ़ने/लिखने की ज़्यादातर कार्रवाइयों के लिए इसका इस्तेमाल करना बेहतर होता है. हालांकि, कभी-कभी Firebase Realtime Database के सर्वर के हिसाब से क्लाइंट की घड़ी के अंतर का अनुमान लगाने के लिए, इसका इस्तेमाल किया जा सकता है. आपके पास, जगह की जानकारी /.info/serverTimeOffset में कॉलबैक अटैच करने का विकल्प होता है. इससे आपको मिलीसेकंड में वह वैल्यू मिलती है जिसे Firebase Realtime Database क्लाइंट, स्थानीय समय (मिलीसेकंड में इपोक टाइम) में जोड़ते हैं, ताकि सर्वर के समय का अनुमान लगाया जा सके. ध्यान दें कि इस ऑफ़सेट की सटीक जानकारी पर नेटवर्क की वजह से होने वाली देरी का असर पड़ सकता है. इसलिए, यह मुख्य रूप से घड़ी के समय में बड़े (> 1 सेकंड) अंतर का पता लगाने के लिए उपयोगी है.
Swift
let offsetRef = Database.database().reference(withPath: ".info/serverTimeOffset") offsetRef.observe(.value, with: { snapshot in if let offset = snapshot.value as? TimeInterval { print("Estimated server time in milliseconds: \(Date().timeIntervalSince1970 * 1000 + offset)") } })
Objective-C
FIRDatabaseReference *offsetRef = [[FIRDatabase database] referenceWithPath:@".info/serverTimeOffset"]; [offsetRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) { NSTimeInterval offset = [(NSNumber *)snapshot.value doubleValue]; NSTimeInterval estimatedServerTimeMs = [[NSDate date] timeIntervalSince1970] * 1000.0 + offset; NSLog(@"Estimated server time: %0.3f", estimatedServerTimeMs); }];
सैंपल के तौर पर उपलब्ध Presence ऐप्लिकेशन
कनेक्शन की स्थिति की निगरानी करने और सर्वर के टाइमस्टैंप के साथ डिसकनेक्ट करने की कार्रवाइयों को मिलाकर, उपयोगकर्ता की मौजूदगी का सिस्टम बनाया जा सकता है. इस सिस्टम में, हर उपयोगकर्ता डेटा को डेटाबेस की किसी जगह पर सेव करता है. इससे यह पता चलता है कि Realtime Database क्लाइंट ऑनलाइन है या नहीं. क्लाइंट, ऑनलाइन होने पर इस जगह की जानकारी को सही के तौर पर सेट करते हैं. साथ ही, डिसकनेक्ट होने पर टाइमस्टैंप सेट करते हैं. इस टाइमस्टैंप से पता चलता है कि उपयोगकर्ता पिछली बार कब ऑनलाइन था.
ध्यान दें कि उपयोगकर्ता को ऑनलाइन के तौर पर मार्क करने से पहले, आपके ऐप्लिकेशन को डिसकनेक्ट करने की कार्रवाइयों को क्रम में लगाना चाहिए. इससे, अगर क्लाइंट का नेटवर्क कनेक्शन सर्वर को दोनों कमांड भेजने से पहले ही बंद हो जाता है, तो रेस कंडीशन से बचा जा सकता है.
उपयोगकर्ता की मौजूदगी का पता लगाने वाला एक आसान सिस्टम यहां दिया गया है:
Swift
// 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 let myConnectionsRef = Database.database().reference(withPath: "users/morgan/connections") // stores the timestamp of my last disconnect (the last time I was seen online) let lastOnlineRef = Database.database().reference(withPath: "users/morgan/lastOnline") let connectedRef = Database.database().reference(withPath: ".info/connected") connectedRef.observe(.value, with: { snapshot in // only handle connection established (or I've reconnected after a loss of connection) guard snapshot.value as? Bool ?? false else { return } // add this device to my connections list let con = myConnectionsRef.childByAutoId() // when this device disconnects, remove it. con.onDisconnectRemoveValue() // The onDisconnect() call is before the call to set() itself. This is to avoid a race condition // where you set the user's presence to true and the client disconnects before the // onDisconnect() operation takes effect, leaving a ghost user. // this value could contain info about the device or a timestamp instead of just true con.setValue(true) // when I disconnect, update the last time I was seen online lastOnlineRef.onDisconnectSetValue(ServerValue.timestamp()) })
Objective-C
// 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 FIRDatabaseReference *myConnectionsRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/connections"]; // stores the timestamp of my last disconnect (the last time I was seen online) FIRDatabaseReference *lastOnlineRef = [[FIRDatabase database] referenceWithPath:@"users/morgan/lastOnline"]; FIRDatabaseReference *connectedRef = [[FIRDatabase database] referenceWithPath:@".info/connected"]; [connectedRef observeEventType:FIRDataEventTypeValue withBlock:^(FIRDataSnapshot *snapshot) { if([snapshot.value boolValue]) { // connection established (or I've reconnected after a loss of connection) // add this device to my connections list FIRDatabaseReference *con = [myConnectionsRef childByAutoId]; // when this device disconnects, remove it [con onDisconnectRemoveValue]; // The onDisconnect() call is before the call to set() itself. This is to avoid a race condition // where you set the user's presence to true and the client disconnects before the // onDisconnect() operation takes effect, leaving a ghost user. // this value could contain info about the device or a timestamp instead of just true [con setValue:@YES]; // when I disconnect, update the last time I was seen online [lastOnlineRef onDisconnectSetValue:[FIRServerValue timestamp]]; } }];