আপনার অ্যাপ সাময়িকভাবে নেটওয়ার্ক কানেকশন হারিয়ে ফেললেও 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];
ডিফল্ট হিসেবে, আগে সিঙ্ক করা ডেটার ১০ এমবি ক্যাশে করা হয়। বেশিরভাগ অ্যাপ্লিকেশনের জন্য এটি যথেষ্ট হওয়া উচিত। ক্যাশে তার কনফিগার করা সাইজের থেকে বড় হয়ে গেলে, 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 ক্লায়েন্ট, সেভ করা ক্যাশে ব্যবহার করে, সবচেয়ে বেশি স্কোর করা দুটি ডাইনোসরের জন্য 'চাইল্ড যোগ করা হয়েছে' ইভেন্ট রেইজ করে। কিন্তু এটি 'ভ্যালু' ইভেন্ট তৈরি করবে না, কারণ অ্যাপটি অনলাইনে থাকাকালীন কখনও সেই কোয়েরি এক্সিকিউট করেনি।
অফলাইনে থাকাকালীন অ্যাপটি শেষ ছয়টি আইটেমের জন্য অনুরোধ করলে, এটি সরাসরি চারটি ক্যাশে করা আইটেমের জন্য 'চাইল্ড যোগ করা হয়েছে' ইভেন্ট পাবে। ডিভাইস আবার অনলাইন হলে, Firebase Realtime Database ক্লায়েন্ট সার্ভারের সাথে সিঙ্ক করে এবং অ্যাপের জন্য শেষ দুটি 'চাইল্ড যোগ করা হয়েছে' এবং 'ভ্যালু' ইভেন্ট পায়।
অফলাইনে ট্রানজ্যাকশন ম্যানেজ করা
অ্যাপ অফলাইন থাকাকালীন কোনও ট্রানজ্যাকশন করা হলে, তা সারিতে রাখা হয়। অ্যাপটি নেটওয়ার্ক কানেক্টিভিটি ফিরে পেলে, ট্রানজ্যাকশন Realtime Database সার্ভারে পাঠানো হয়।
উপস্থিতি ম্যানেজ করা
রিয়েল-টাইম অ্যাপ্লিকেশনে ক্লায়েন্ট কখন কানেক্ট ও ডিসকানেক্ট করছে তা শনাক্ত করা প্রায়ই কাজে লাগে। যেমন, আপনি হয়ত কোনও ব্যবহারকারীর ক্লায়েন্ট ডিসকানেক্ট হয়ে গেলে তাকে 'অফলাইন' হিসেবে চিহ্নিত করতে চান।
Firebase ডেটাবেস ক্লায়েন্ট সহজ প্রিমিটিভ প্রদান করে যা আপনি Firebase ডেটাবেস সার্ভার থেকে ক্লায়েন্ট ডিসকানেক্ট হয়ে গেলে ডেটাবেসে লেখার জন্য ব্যবহার করতে পারেন। ক্লায়েন্ট সঠিকভাবে ডিসকানেক্ট করুক বা না করুক, এই আপডেটগুলি হয়, তাই কানেকশন ড্রপ হলে বা ক্লায়েন্ট ক্র্যাশ করলেও, ডেটা ক্লিন-আপ করার জন্য আপনি এগুলির উপর নির্ভর করতে পারেন। ডিসকানেক্ট করার পরে, সেট করা, আপডেট করা ও সরিয়ে দেওয়া সহ সব রাইট অপারেশন করা যাবে।
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-এর সার্ভারের সাপেক্ষে ক্লায়েন্টের ঘড়ির স্কিউ অনুমান করতে
উপযোগী হতে পারে। সার্ভারের সময় অনুমান করতে,
স্থানীয়ভাবে রিপোর্ট করা সময়ে (মিলিসেকেন্ডে ইপক সময়) Firebase Realtime Database ক্লায়েন্ট
যে ভ্যালু যোগ করে, তা মিলিসেকেন্ডে পেতে,
আপনি লোকেশন /.info/serverTimeOffset-এ কলব্যাক অ্যাটাচ করতে
পারবেন। মনে রাখবেন যে নেটওয়ার্কিং লেটেন্সি এই অফসেটের নির্ভুলতাকে প্রভাবিত করতে পারে, তাই এটি মূলত ঘড়ির সময়ে বড় (> ১ সেকেন্ড) অসঙ্গতি
খুঁজে বের করার জন্য উপযোগী।
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); }];
Sample 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]]; } }];