আপনার অ্যাপটি সাময়িকভাবে নেটওয়ার্ক সংযোগ বিচ্ছিন্ন করলেও Firebase অ্যাপ্লিকেশনগুলি কাজ করে। এছাড়াও, Firebase স্থানীয়ভাবে ডেটা ধরে রাখার, উপস্থিতি পরিচালনা করার এবং লেটেন্সি পরিচালনা করার জন্য সরঞ্জাম সরবরাহ করে।
ডিস্ক পারসিস্টেন্স
ফায়ারবেস অ্যাপগুলি স্বয়ংক্রিয়ভাবে অস্থায়ী নেটওয়ার্ক বাধাগুলি পরিচালনা করে। অফলাইনে থাকাকালীন ক্যাশেড ডেটা পাওয়া যায় এবং নেটওয়ার্ক সংযোগ পুনরুদ্ধার করা হলে ফায়ারবেস যেকোনো লেখা পুনরায় পাঠায়।
যখন আপনি ডিস্ক পারসিস্ট্যান্স সক্ষম করেন, তখন আপনার অ্যাপটি ডিভাইসে স্থানীয়ভাবে ডেটা লিখে রাখে যাতে ব্যবহারকারী বা অপারেটিং সিস্টেম অ্যাপটি পুনরায় চালু করলেও অফলাইনে থাকাকালীন আপনার অ্যাপটি অবস্থা বজায় রাখতে পারে।
আপনি শুধুমাত্র এক লাইন কোড দিয়ে ডিস্ক পারসিস্টেন্স সক্রিয় করতে পারেন।
Kotlin
Firebase.database.setPersistenceEnabled(true)
Java
FirebaseDatabase.getInstance().setPersistenceEnabled(true);
অধ্যবসায় আচরণ
স্থায়িত্ব সক্ষম করার মাধ্যমে, Firebase Realtime Database ক্লায়েন্ট অনলাইনে থাকাকালীন যে কোনও ডেটা সিঙ্ক করবে তা ডিস্কে টিকে থাকবে এবং অফলাইনে উপলব্ধ থাকবে, এমনকি ব্যবহারকারী বা অপারেটিং সিস্টেম অ্যাপটি পুনরায় চালু করলেও। এর অর্থ হল ক্যাশে সংরক্ষিত স্থানীয় ডেটা ব্যবহার করে আপনার অ্যাপটি অনলাইনে যেমন কাজ করে তেমনই কাজ করবে। স্থানীয় আপডেটের জন্য শ্রোতাদের কলব্যাক চলতে থাকবে।
Firebase Realtime Database ক্লায়েন্ট স্বয়ংক্রিয়ভাবে আপনার অ্যাপ অফলাইনে থাকাকালীন সম্পাদিত সমস্ত লেখার ক্রিয়াকলাপের একটি সারি রাখে। যখন পারসিস্ট্যান্স সক্ষম করা হয়, তখন এই সারিটি ডিস্কেও স্থায়ী হয় যাতে ব্যবহারকারী বা অপারেটিং সিস্টেম অ্যাপটি পুনরায় চালু করলে আপনার সমস্ত লেখা উপলব্ধ থাকে। যখন অ্যাপটি সংযোগ ফিরে পায়, তখন সমস্ত ক্রিয়াকলাপ Firebase Realtime Database সার্ভারে পাঠানো হয়।
যদি আপনার অ্যাপ Firebase Authentication ব্যবহার করে, Firebase Realtime Database ক্লায়েন্ট অ্যাপ রিস্টার্টের সময় ব্যবহারকারীর প্রমাণীকরণ টোকেন ধরে রাখে। যদি আপনার অ্যাপ অফলাইনে থাকাকালীন প্রমাণীকরণ টোকেনের মেয়াদ শেষ হয়ে যায়, তাহলে ক্লায়েন্ট আপনার অ্যাপ ব্যবহারকারীকে পুনরায় প্রমাণীকরণ না করা পর্যন্ত লেখার কাজ থামায়, অন্যথায় নিরাপত্তা নিয়মের কারণে লেখার কাজ ব্যর্থ হতে পারে।
ডেটা তাজা রাখা
Firebase Realtime Database সক্রিয় শ্রোতাদের জন্য ডেটার একটি স্থানীয় কপি সিঙ্ক্রোনাইজ এবং সংরক্ষণ করে। এছাড়াও, আপনি নির্দিষ্ট অবস্থানগুলিকে সিঙ্কে রাখতে পারেন।
Kotlin
val scoresRef = Firebase.database.getReference("scores") scoresRef.keepSynced(true)
Java
DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores"); scoresRef.keepSynced(true);
Firebase Realtime Database ক্লায়েন্ট স্বয়ংক্রিয়ভাবে এই অবস্থানগুলিতে ডেটা ডাউনলোড করে এবং রেফারেন্সে কোনও সক্রিয় শ্রোতা না থাকলেও এটি সিঙ্ক্রোনাইজ করে রাখে। আপনি নিম্নলিখিত কোডের লাইন দিয়ে সিঙ্ক্রোনাইজেশন আবার বন্ধ করতে পারেন।
Kotlin
scoresRef.keepSynced(false)
Java
scoresRef.keepSynced(false);
ডিফল্টরূপে, পূর্বে সিঙ্ক করা ১০ এমবি ডেটা ক্যাশে করা হয়। বেশিরভাগ অ্যাপ্লিকেশনের জন্য এটি যথেষ্ট হওয়া উচিত। যদি ক্যাশে তার কনফিগার করা আকারের চেয়ে বড় হয়, তাহলে Firebase Realtime Database সম্প্রতি সবচেয়ে কম ব্যবহৃত ডেটা মুছে ফেলে। সিঙ্কে রাখা ডেটা ক্যাশে থেকে মুছে ফেলা হয় না।
অফলাইনে ডেটা অনুসন্ধান করা হচ্ছে
Firebase Realtime Database অফলাইনে ব্যবহারের জন্য কোনও কোয়েরি থেকে ফিরে আসা ডেটা সংরক্ষণ করে। অফলাইনে তৈরি কোয়েরির ক্ষেত্রে, Firebase Realtime Database পূর্বে লোড করা ডেটার জন্য কাজ চালিয়ে যায়। যদি অনুরোধ করা ডেটা লোড না হয়, Firebase Realtime Database স্থানীয় ক্যাশে থেকে ডেটা লোড করে। যখন নেটওয়ার্ক সংযোগ আবার উপলব্ধ হয়, তখন ডেটা লোড হয় এবং কোয়েরিটি প্রতিফলিত করে।
উদাহরণস্বরূপ, এই কোডটি Firebase Realtime Database শেষ চারটি আইটেমের জন্য স্কোরের জন্য অনুসন্ধান করে
Kotlin
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}") } // ... })
Java
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()); } // ... });
ধরে নিন যে ব্যবহারকারী সংযোগ বিচ্ছিন্ন করে, অফলাইনে চলে যান এবং অ্যাপটি পুনরায় চালু করেন। অফলাইন থাকাকালীন, অ্যাপটি একই অবস্থান থেকে শেষ দুটি আইটেমের জন্য অনুসন্ধান করে। এই অনুসন্ধানটি শেষ দুটি আইটেম সফলভাবে ফিরিয়ে দেবে কারণ অ্যাপটি উপরের কোয়েরিতে চারটি আইটেম লোড করেছে।
Kotlin
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}") } // ... })
Java
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()); } // ... });
পূর্ববর্তী উদাহরণে, Firebase Realtime Database ক্লায়েন্ট সর্বোচ্চ স্কোরকারী দুটি ডাইনোসরের জন্য 'শিশু যুক্ত' ইভেন্টগুলি উত্থাপন করে, স্থায়ী ক্যাশে ব্যবহার করে। কিন্তু এটি কোনও 'মান' ইভেন্ট উত্থাপন করবে না, কারণ অ্যাপটি অনলাইনে থাকাকালীন কখনও সেই কোয়েরিটি কার্যকর করেনি।
যদি অ্যাপটি অফলাইনে থাকাকালীন শেষ ছয়টি আইটেমের জন্য অনুরোধ করে, তাহলে এটি চারটি ক্যাশে করা আইটেমের জন্য 'শিশু যোগ করা' ইভেন্টগুলি সরাসরি পাবে। ডিভাইসটি আবার অনলাইনে ফিরে এলে, Firebase Realtime Database ক্লায়েন্ট সার্ভারের সাথে সিঙ্ক্রোনাইজ করে এবং অ্যাপের জন্য শেষ দুটি 'শিশু যোগ করা' এবং 'মান' ইভেন্টগুলি পায়।
অফলাইনে লেনদেন পরিচালনা করা
অ্যাপটি অফলাইন থাকাকালীন সম্পাদিত যেকোনো লেনদেন সারিবদ্ধভাবে করা হয়। অ্যাপটি নেটওয়ার্ক সংযোগ ফিরে পেলে, লেনদেনগুলি Realtime Database সার্ভারে পাঠানো হয়।
উপস্থিতি পরিচালনা
রিয়েলটাইম অ্যাপ্লিকেশনগুলিতে ক্লায়েন্ট কখন সংযোগ স্থাপন করে এবং সংযোগ বিচ্ছিন্ন করে তা সনাক্ত করা প্রায়শই কার্যকর। উদাহরণস্বরূপ, আপনি কোনও ব্যবহারকারীর ক্লায়েন্ট সংযোগ বিচ্ছিন্ন হয়ে গেলে তাকে 'অফলাইন' হিসাবে চিহ্নিত করতে পারেন।
ফায়ারবেস ডেটাবেস ক্লায়েন্টরা সহজ প্রিমিটিভ প্রদান করে যা আপনি যখন কোনও ক্লায়েন্ট ফায়ারবেস ডেটাবেস সার্ভার থেকে সংযোগ বিচ্ছিন্ন করে তখন ডাটাবেসে লেখার জন্য ব্যবহার করতে পারেন। ক্লায়েন্ট পরিষ্কারভাবে সংযোগ বিচ্ছিন্ন করুক বা না করুক, এই আপডেটগুলি ঘটে, তাই কোনও সংযোগ বিচ্ছিন্ন হয়ে গেলে বা ক্লায়েন্ট ক্র্যাশ করলেও আপনি ডেটা পরিষ্কার করার জন্য তাদের উপর নির্ভর করতে পারেন। সংযোগ বিচ্ছিন্ন হওয়ার পরে সেট করা, আপডেট করা এবং অপসারণ সহ সমস্ত লেখার ক্রিয়াকলাপ সম্পাদন করা যেতে পারে।
onDisconnect প্রিমিটিভ ব্যবহার করে সংযোগ বিচ্ছিন্ন করার সময় ডেটা লেখার একটি সহজ উদাহরণ এখানে দেওয়া হল:
Kotlin
val presenceRef = Firebase.database.getReference("disconnectmessage") // Write a string when this client loses connection presenceRef.onDisconnect().setValue("I disconnected!")
Java
DatabaseReference presenceRef = FirebaseDatabase.getInstance().getReference("disconnectmessage"); // Write a string when this client loses connection presenceRef.onDisconnect().setValue("I disconnected!");
অনডিসকানেক্ট কীভাবে কাজ করে
যখন আপনি একটি onDisconnect() অপারেশন স্থাপন করেন, তখন অপারেশনটি Firebase Realtime Database সার্ভারে থাকে। ব্যবহারকারী অনুরোধ করা লেখার ইভেন্টটি সম্পাদন করতে পারছেন কিনা তা নিশ্চিত করার জন্য সার্ভার নিরাপত্তা পরীক্ষা করে এবং যদি এটি অবৈধ হয় তবে আপনার অ্যাপটিকে অবহিত করে। সার্ভার তারপর সংযোগটি পর্যবেক্ষণ করে। যদি কোনও সময়ে সংযোগের সময়সীমা শেষ হয়ে যায়, অথবা Realtime Database ক্লায়েন্ট দ্বারা সক্রিয়ভাবে বন্ধ করা হয়, তাহলে সার্ভার দ্বিতীয়বার নিরাপত্তা পরীক্ষা করে (অপারেশনটি এখনও বৈধ কিনা তা নিশ্চিত করার জন্য) এবং তারপর ইভেন্টটি চালু করে।
আপনার অ্যাপটি onDisconnect সঠিকভাবে সংযুক্ত হয়েছে কিনা তা নিশ্চিত করতে write অপারেশনে কলব্যাক ব্যবহার করতে পারে:
Kotlin
presenceRef.onDisconnect().removeValue { error, reference -> error?.let { Log.d(TAG, "could not establish onDisconnect event: ${error.message}") } }
Java
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()); } } });
একটি onDisconnect ইভেন্ট .cancel() কল করেও বাতিল করা যেতে পারে:
Kotlin
val onDisconnectRef = presenceRef.onDisconnect() onDisconnectRef.setValue("I disconnected") // ... // some time later when we change our minds // ... onDisconnectRef.cancel()
Java
OnDisconnect onDisconnectRef = presenceRef.onDisconnect(); onDisconnectRef.setValue("I disconnected"); // ... // some time later when we change our minds // ... onDisconnectRef.cancel();
সংযোগের অবস্থা সনাক্ত করা হচ্ছে
অনেক উপস্থিতি-সম্পর্কিত বৈশিষ্ট্যের জন্য, আপনার অ্যাপটি কখন অনলাইন বা অফলাইনে আছে তা জানা আপনার জন্য কার্যকর। Firebase Realtime Database /.info/connected এ একটি বিশেষ অবস্থান প্রদান করে যা Firebase Realtime Database ক্লায়েন্টের সংযোগ অবস্থা পরিবর্তনের সাথে সাথে প্রতিবার আপডেট করা হয়। এখানে একটি উদাহরণ দেওয়া হল:
Kotlin
val connectedRef = Firebase.database.getReference(".info/connected") connectedRef.addValueEventListener(object : ValueEventListener { override fun onDataChange(snapshot: DataSnapshot) { val connected = snapshot.getValue(Boolean::class.java) ?: false if (connected) { Log.d(TAG, "connected") } else { Log.d(TAG, "not connected") } } override fun onCancelled(error: DatabaseError) { Log.w(TAG, "Listener was cancelled") } })
Java
DatabaseReference connectedRef = FirebaseDatabase.getInstance().getReference(".info/connected"); connectedRef.addValueEventListener(new ValueEventListener() { @Override public void onDataChange(@NonNull DataSnapshot snapshot) { boolean connected = snapshot.getValue(Boolean.class); if (connected) { Log.d(TAG, "connected"); } else { Log.d(TAG, "not connected"); } } @Override public void onCancelled(@NonNull DatabaseError error) { Log.w(TAG, "Listener was cancelled"); } });
/.info/connected হল একটি বুলিয়ান মান যা Realtime Database ক্লায়েন্টদের মধ্যে সিঙ্ক্রোনাইজ করা হয় না কারণ মানটি ক্লায়েন্টের অবস্থার উপর নির্ভর করে। অন্য কথায়, যদি একটি ক্লায়েন্ট /.info/connected মিথ্যা হিসেবে পড়ে, তাহলে এটি কোনও গ্যারান্টি দেয় না যে একটি পৃথক ক্লায়েন্টও মিথ্যা পড়বে।
অ্যান্ড্রয়েডে, ফায়ারবেস স্বয়ংক্রিয়ভাবে সংযোগের অবস্থা পরিচালনা করে ব্যান্ডউইথ এবং ব্যাটারির ব্যবহার কমাতে। যখন কোনও ক্লায়েন্টের কোনও সক্রিয় শ্রোতা থাকে না, কোনও মুলতুবি লেখা বা onDisconnect অপারেশন থাকে না এবং goOffline পদ্ধতি দ্বারা স্পষ্টভাবে সংযোগ বিচ্ছিন্ন না হয়, তখন ফায়ারবেস 60 সেকেন্ড নিষ্ক্রিয়তার পরে সংযোগটি বন্ধ করে দেয়।
বিলম্ব সামলানো
সার্ভার টাইমস্ট্যাম্প
Firebase Realtime Database সার্ভারগুলি সার্ভারে তৈরি টাইমস্ট্যাম্পগুলিকে ডেটা হিসাবে সন্নিবেশ করার জন্য একটি প্রক্রিয়া প্রদান করে। এই বৈশিষ্ট্যটি, onDisconnect এর সাথে মিলিত হয়ে, একটি Realtime Database ক্লায়েন্ট সংযোগ বিচ্ছিন্ন হওয়ার সময় নির্ভরযোগ্যভাবে নোট করার একটি সহজ উপায় প্রদান করে:
Kotlin
val userLastOnlineRef = Firebase.database.getReference("users/joe/lastOnline") userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP)
Java
DatabaseReference userLastOnlineRef = FirebaseDatabase.getInstance().getReference("users/joe/lastOnline"); userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP);
ঘড়ির স্কিউ
যদিও firebase.database.ServerValue.TIMESTAMP অনেক বেশি নির্ভুল এবং বেশিরভাগ পঠন/লেখার ক্রিয়াকলাপের জন্য পছন্দনীয়, তবুও মাঝে মাঝে Firebase Realtime Database এর সার্ভারের তুলনায় ক্লায়েন্টের ঘড়ির স্কিউ অনুমান করা কার্যকর হতে পারে। আপনি /.info/serverTimeOffset অবস্থানে একটি কলব্যাক সংযুক্ত করতে পারেন যাতে Firebase Realtime Database ক্লায়েন্টরা সার্ভারের সময় অনুমান করার জন্য স্থানীয় রিপোর্ট করা সময়ের (যুগের সময় মিলিসেকেন্ডে) যোগ করে যে মান মিলিসেকেন্ডে পেতে পারে। মনে রাখবেন যে এই অফসেটের নির্ভুলতা নেটওয়ার্কিং ল্যাটেন্সি দ্বারা প্রভাবিত হতে পারে এবং তাই এটি প্রাথমিকভাবে ঘড়ির সময়ের মধ্যে বড় (> 1 সেকেন্ড) অসঙ্গতি আবিষ্কারের জন্য কার্যকর।
Kotlin
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") } })
Java
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"); } });
নমুনা উপস্থিতি অ্যাপ
সংযোগ অবস্থা পর্যবেক্ষণ এবং সার্ভার টাইমস্ট্যাম্পের সাথে সংযোগ বিচ্ছিন্নকরণ অপারেশনগুলিকে একত্রিত করে, আপনি একটি ব্যবহারকারীর উপস্থিতি সিস্টেম তৈরি করতে পারেন। এই সিস্টেমে, প্রতিটি ব্যবহারকারী একটি Realtime Database ক্লায়েন্ট অনলাইন কিনা তা নির্দেশ করার জন্য একটি ডাটাবেস অবস্থানে ডেটা সংরক্ষণ করে। ক্লায়েন্টরা অনলাইনে আসার সময় এই অবস্থানটিকে সত্য হিসাবে সেট করে এবং সংযোগ বিচ্ছিন্ন করার সময় একটি টাইমস্ট্যাম্প সেট করে। এই টাইমস্ট্যাম্পটি নির্দেশ করে যে প্রদত্ত ব্যবহারকারী শেষ কবে অনলাইনে ছিলেন।
মনে রাখবেন যে কোনও ব্যবহারকারীকে অনলাইনে চিহ্নিত করার আগে আপনার অ্যাপের ডিসকানেক্ট অপারেশনগুলি সারিবদ্ধ করা উচিত, যাতে উভয় কমান্ড সার্ভারে পাঠানোর আগে ক্লায়েন্টের নেটওয়ার্ক সংযোগ বিচ্ছিন্ন হয়ে গেলে কোনও রেস কন্ডিশন এড়ানো যায়।
এখানে একটি সহজ ব্যবহারকারী উপস্থিতি সিস্টেম রয়েছে:
Kotlin
// 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 val database = Firebase.database val myConnectionsRef = database.getReference("users/joe/connections") // Stores the timestamp of my last disconnect (the last time I was seen online) val lastOnlineRef = database.getReference("/users/joe/lastOnline") val connectedRef = database.getReference(".info/connected") connectedRef.addValueEventListener(object : ValueEventListener { override fun onDataChange(snapshot: DataSnapshot) { val connected = snapshot.getValue<Boolean>() ?: false if (connected) { val con = myConnectionsRef.push() // When this device disconnects, remove it con.onDisconnect().removeValue() // When I disconnect, update the last time I was seen online lastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP) // Add this device to my connections list // this value could contain info about the device or a timestamp too con.setValue(java.lang.Boolean.TRUE) } } override fun onCancelled(error: DatabaseError) { Log.w(TAG, "Listener was cancelled at .info/connected") } })
Java
// 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 FirebaseDatabase database = FirebaseDatabase.getInstance(); final DatabaseReference myConnectionsRef = database.getReference("users/joe/connections"); // Stores the timestamp of my last disconnect (the last time I was seen online) final DatabaseReference lastOnlineRef = database.getReference("/users/joe/lastOnline"); final DatabaseReference connectedRef = database.getReference(".info/connected"); connectedRef.addValueEventListener(new ValueEventListener() { @Override public void onDataChange(@NonNull DataSnapshot snapshot) { boolean connected = snapshot.getValue(Boolean.class); if (connected) { DatabaseReference con = myConnectionsRef.push(); // When this device disconnects, remove it con.onDisconnect().removeValue(); // When I disconnect, update the last time I was seen online lastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP); // Add this device to my connections list // this value could contain info about the device or a timestamp too con.setValue(Boolean.TRUE); } } @Override public void onCancelled(@NonNull DatabaseError error) { Log.w(TAG, "Listener was cancelled at .info/connected"); } });