অ্যান্ড্রয়েডে ডেটার তালিকা নিয়ে কাজ করুন

এই দস্তাবেজটি Firebase-এ ডেটার তালিকা নিয়ে কাজ করে। ফায়ারবেস ডেটা পড়ার এবং লেখার প্রাথমিক বিষয়গুলি শিখতে Android এ ডেটা পড়ুন এবং লিখুন দেখুন।

একটি ডেটাবেস রেফারেন্স পান

ডাটাবেস থেকে ডেটা পড়তে এবং লিখতে, আপনার DatabaseReference একটি উদাহরণ প্রয়োজন:

private lateinit var database: DatabaseReference
// ...
database = Firebase.database.reference
ReadAndWriteSnippets.kt

private DatabaseReference mDatabase;
// ...
mDatabase = FirebaseDatabase.getInstance().getReference();
ReadAndWriteSnippets.java

তালিকা পড়ুন এবং লিখুন

ডেটার তালিকায় যুক্ত করুন

মাল্টি-ইউজার অ্যাপ্লিকেশনের তালিকায় ডেটা যুক্ত করতে push() পদ্ধতি ব্যবহার করুন। push() পদ্ধতিটি নির্দিষ্ট ফায়ারবেস রেফারেন্সে একটি নতুন শিশু যোগ করার সময় একটি অনন্য কী তৈরি করে। তালিকার প্রতিটি নতুন উপাদানের জন্য এই স্বয়ংক্রিয়-উত্পাদিত কীগুলি ব্যবহার করে, অনেক ক্লায়েন্ট একই সময়ে শিশুদের লেখার দ্বন্দ্ব ছাড়াই একই স্থানে যুক্ত করতে পারে। push() দ্বারা উত্পন্ন অনন্য কী একটি টাইমস্ট্যাম্পের উপর ভিত্তি করে, তাই তালিকা আইটেমগুলি স্বয়ংক্রিয়ভাবে কালানুক্রমিকভাবে অর্ডার করা হয়।

আপনি সন্তানের স্বয়ংক্রিয়-উত্পাদিত কী বা সন্তানের জন্য সেট ডেটার মান পেতে push() পদ্ধতি দ্বারা প্রত্যাবর্তিত নতুন ডেটার রেফারেন্স ব্যবহার করতে পারেন। একটি push() রেফারেন্সে getKey() কল করা স্বয়ংক্রিয়-উত্পন্ন কীটির মান প্রদান করে।

আপনি আপনার ডেটা স্ট্রাকচারকে সমতল করার জন্য এই স্বয়ংক্রিয়-উত্পন্ন কীগুলি ব্যবহার করতে পারেন। আরও তথ্যের জন্য, ডেটা ফ্যান-আউট উদাহরণ দেখুন।

শিশু ঘটনা শুনুন

তালিকাগুলির সাথে কাজ করার সময়, আপনার অ্যাপ্লিকেশনটি একক বস্তুর জন্য ব্যবহৃত মূল্যের ইভেন্টগুলির পরিবর্তে চাইল্ড ইভেন্টগুলির জন্য শোনা উচিত।

শিশু ঘটনাগুলি নির্দিষ্ট অপারেশনের প্রতিক্রিয়া হিসাবে ট্রিগার করা হয় যা একটি অপারেশন থেকে নোডের শিশুদের ক্ষেত্রে ঘটে যেমন push() পদ্ধতির মাধ্যমে একটি নতুন শিশু যোগ করা বা updateChildren() পদ্ধতির মাধ্যমে একটি শিশু আপডেট করা। ডাটাবেসের একটি নির্দিষ্ট নোডের পরিবর্তনগুলি শোনার জন্য এইগুলির প্রত্যেকটি একসাথে কার্যকর হতে পারে।

DatabaseReference এ শিশু ঘটনা শোনার জন্য, একটি ChildEventListener সংযুক্ত করুন:

উদাহরণস্বরূপ, একটি সামাজিক ব্লগিং অ্যাপ একটি পোস্টের মন্তব্যে কার্যকলাপ নিরীক্ষণ করতে এই পদ্ধতিগুলি একসাথে ব্যবহার করতে পারে, যেমনটি নীচে দেখানো হয়েছে:

val childEventListener = object : ChildEventListener {
    override fun onChildAdded(dataSnapshot: DataSnapshot, previousChildName: String?) {
        Log.d(TAG, "onChildAdded:" + dataSnapshot.key!!)

        // A new comment has been added, add it to the displayed list
        val comment = dataSnapshot.getValue<Comment>()

        // ...
    }

    override fun onChildChanged(dataSnapshot: DataSnapshot, previousChildName: String?) {
        Log.d(TAG, "onChildChanged: ${dataSnapshot.key}")

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so displayed the changed comment.
        val newComment = dataSnapshot.getValue<Comment>()
        val commentKey = dataSnapshot.key

        // ...
    }

    override fun onChildRemoved(dataSnapshot: DataSnapshot) {
        Log.d(TAG, "onChildRemoved:" + dataSnapshot.key!!)

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so remove it.
        val commentKey = dataSnapshot.key

        // ...
    }

    override fun onChildMoved(dataSnapshot: DataSnapshot, previousChildName: String?) {
        Log.d(TAG, "onChildMoved:" + dataSnapshot.key!!)

        // A comment has changed position, use the key to determine if we are
        // displaying this comment and if so move it.
        val movedComment = dataSnapshot.getValue<Comment>()
        val commentKey = dataSnapshot.key

        // ...
    }

    override fun onCancelled(databaseError: DatabaseError) {
        Log.w(TAG, "postComments:onCancelled", databaseError.toException())
        Toast.makeText(
            context,
            "Failed to load comments.",
            Toast.LENGTH_SHORT,
        ).show()
    }
}
databaseReference.addChildEventListener(childEventListener)
QueryActivity.kt

ChildEventListener childEventListener = new ChildEventListener() {
    @Override
    public void onChildAdded(DataSnapshot dataSnapshot, String previousChildName) {
        Log.d(TAG, "onChildAdded:" + dataSnapshot.getKey());

        // A new comment has been added, add it to the displayed list
        Comment comment = dataSnapshot.getValue(Comment.class);

        // ...
    }

    @Override
    public void onChildChanged(DataSnapshot dataSnapshot, String previousChildName) {
        Log.d(TAG, "onChildChanged:" + dataSnapshot.getKey());

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so displayed the changed comment.
        Comment newComment = dataSnapshot.getValue(Comment.class);
        String commentKey = dataSnapshot.getKey();

        // ...
    }

    @Override
    public void onChildRemoved(DataSnapshot dataSnapshot) {
        Log.d(TAG, "onChildRemoved:" + dataSnapshot.getKey());

        // A comment has changed, use the key to determine if we are displaying this
        // comment and if so remove it.
        String commentKey = dataSnapshot.getKey();

        // ...
    }

    @Override
    public void onChildMoved(DataSnapshot dataSnapshot, String previousChildName) {
        Log.d(TAG, "onChildMoved:" + dataSnapshot.getKey());

        // A comment has changed position, use the key to determine if we are
        // displaying this comment and if so move it.
        Comment movedComment = dataSnapshot.getValue(Comment.class);
        String commentKey = dataSnapshot.getKey();

        // ...
    }

    @Override
    public void onCancelled(DatabaseError databaseError) {
        Log.w(TAG, "postComments:onCancelled", databaseError.toException());
        Toast.makeText(mContext, "Failed to load comments.",
                Toast.LENGTH_SHORT).show();
    }
};
databaseReference.addChildEventListener(childEventListener);
QueryActivity.java

মান ঘটনা জন্য শুনুন

একটি ChildEventListener ব্যবহার করা ডেটার তালিকা পড়ার প্রস্তাবিত উপায়, এমন পরিস্থিতিতে আছে যেখানে একটি তালিকার রেফারেন্সের সাথে একটি ValueEventListener সংযুক্ত করা দরকারী।

ডেটার একটি তালিকার সাথে একটি ValueEventListener সংযুক্ত করা ডেটার সম্পূর্ণ তালিকাকে একটি একক DataSnapshot হিসাবে ফিরিয়ে দেবে, যা আপনি আলাদা বাচ্চাদের অ্যাক্সেস করতে লুপ করতে পারেন৷

এমনকি যখন ক্যোয়ারীটির জন্য শুধুমাত্র একটি মিল থাকে, তখনও স্ন্যাপশটটি একটি তালিকা; এটা শুধু একটি আইটেম রয়েছে. আইটেমটি অ্যাক্সেস করতে, আপনাকে ফলাফলটি লুপ করতে হবে:

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        for (postSnapshot in dataSnapshot.children) {
            // TODO: handle the post
        }
    }

    override fun onCancelled(databaseError: DatabaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException())
        // ...
    }
})
QueryActivity.kt

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot dataSnapshot) {
        for (DataSnapshot postSnapshot: dataSnapshot.getChildren()) {
            // TODO: handle the post
        }
    }

    @Override
    public void onCancelled(@NonNull DatabaseError databaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException());
        // ...
    }
});
QueryActivity.java

এই প্যাটার্নটি উপযোগী হতে পারে যখন আপনি অতিরিক্ত onChildAdded ইভেন্টের জন্য শোনার পরিবর্তে একটি একক অপারেশনে একটি তালিকার সমস্ত শিশু আনতে চান।

শ্রোতাদের বিচ্ছিন্ন করুন

আপনার ফায়ারবেস ডাটাবেস রেফারেন্সে removeEventListener() পদ্ধতিতে কল করার মাধ্যমে কলব্যাকগুলি সরানো হয়।

যদি কোনও শ্রোতাকে একটি ডেটা অবস্থানে একাধিকবার যুক্ত করা হয়, তবে প্রতিটি ইভেন্টের জন্য এটি একাধিকবার বলা হয় এবং এটি সম্পূর্ণরূপে অপসারণ করতে আপনাকে অবশ্যই একই সংখ্যক বার আলাদা করতে হবে।

একটি অভিভাবক শ্রোতাকে removeEventListener() কল করা স্বয়ংক্রিয়ভাবে তার চাইল্ড নোডগুলিতে নিবন্ধিত শ্রোতাদের সরিয়ে দেয় না; removeEventListener() যেকোন শিশু শ্রোতাদের কলব্যাক অপসারণের জন্যও ডাকতে হবে।

তথ্য বাছাই এবং ফিল্টারিং

কী, মান অনুসারে বা শিশুর মান অনুসারে বাছাই করা ডেটা পুনরুদ্ধার করতে আপনি Realtime Database Query ক্লাস ব্যবহার করতে পারেন। আপনি বাছাই করা ফলাফলকে নির্দিষ্ট সংখ্যক ফলাফল বা কী বা মানের পরিসরে ফিল্টার করতে পারেন।

তথ্য সাজান

বাছাই করা ডেটা পুনরুদ্ধার করতে, ফলাফলগুলি কীভাবে অর্ডার করা হয় তা নির্ধারণ করতে অর্ডার-বাই পদ্ধতিগুলির একটি নির্দিষ্ট করে শুরু করুন:

আপনি একটি সময়ে শুধুমাত্র একটি অর্ডার পদ্ধতি ব্যবহার করতে পারেন. একই ক্যোয়ারীতে একাধিকবার অর্ডার-বাই মেথড কল করলে একটি ত্রুটি দেখা দেয়।

নিম্নলিখিত উদাহরণটি দেখায় যে আপনি কীভাবে একজন ব্যবহারকারীর শীর্ষ পোস্টের তালিকা পুনরুদ্ধার করতে পারেন তাদের তারকা সংখ্যা অনুসারে সাজানো:

// My top posts by number of stars
val myUserId = uid
val myTopPostsQuery = databaseReference.child("user-posts").child(myUserId)
    .orderByChild("starCount")

myTopPostsQuery.addChildEventListener(object : ChildEventListener {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
})
QueryActivity.kt

// My top posts by number of stars
String myUserId = getUid();
Query myTopPostsQuery = databaseReference.child("user-posts").child(myUserId)
        .orderByChild("starCount");
myTopPostsQuery.addChildEventListener(new ChildEventListener() {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
});
QueryActivity.java

এটি একটি ক্যোয়ারীকে সংজ্ঞায়িত করে যেটি একটি শিশু শ্রোতার সাথে মিলিত হলে ক্লায়েন্টকে তাদের ব্যবহারকারী আইডির উপর ভিত্তি করে ডাটাবেসের পাথ থেকে ব্যবহারকারীর পোস্টের সাথে সিঙ্ক্রোনাইজ করে, প্রতিটি পোস্টে প্রাপ্ত তারার সংখ্যা অনুসারে অর্ডার করা হয়। আইডিগুলিকে সূচক কী হিসাবে ব্যবহার করার এই কৌশলটিকে ডেটা ফ্যান আউট বলা হয়, আপনি এটি সম্পর্কে আরও পড়তে পারেন আপনার ডেটাবেসের কাঠামোতে ।

orderByChild() পদ্ধতিতে কল করা ফলাফলের অর্ডার করার জন্য চাইল্ড কী নির্দিষ্ট করে। এই ক্ষেত্রে, পোস্টগুলি তাদের নিজ নিজ "starCount" সন্তানের মান অনুসারে সাজানো হয়। আপনার কাছে এমন ডেটা থাকলে নেস্টেড বাচ্চাদের দ্বারাও কোয়েরি অর্ডার করা যেতে পারে:

"posts": {
  "ts-functions": {
    "metrics": {
      "views" : 1200000,
      "likes" : 251000,
      "shares": 1200,
    },
    "title" : "Why you should use TypeScript for writing Cloud Functions",
    "author": "Doug",
  },
  "android-arch-3": {
    "metrics": {
      "views" : 900000,
      "likes" : 117000,
      "shares": 144,
    },
    "title" : "Using Android Architecture Components with Firebase Realtime Database (Part 3)",
    "author": "Doug",
  }
},

এই উদাহরণে, আমরা আমাদের orderByChild() কলে নেস্টেড চাইল্ডের আপেক্ষিক পাথ নির্দিষ্ট করে metrics কী-এর অধীনে নেস্ট করা মান অনুসারে আমাদের তালিকার উপাদানগুলিকে অর্ডার করতে পারি।

// Most viewed posts
val myMostViewedPostsQuery = databaseReference.child("posts")
    .orderByChild("metrics/views")
myMostViewedPostsQuery.addChildEventListener(object : ChildEventListener {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
})
QueryActivity.kt

// Most viewed posts
Query myMostViewedPostsQuery = databaseReference.child("posts")
        .orderByChild("metrics/views");
myMostViewedPostsQuery.addChildEventListener(new ChildEventListener() {
    // TODO: implement the ChildEventListener methods as documented above
    // ...
});
QueryActivity.java

অন্যান্য ডেটার ধরনগুলি কীভাবে অর্ডার করা হয় সে সম্পর্কে আরও তথ্যের জন্য, কীভাবে কোয়েরি ডেটা অর্ডার করা হয় তা দেখুন৷

ফিল্টারিং ডেটা

ডেটা ফিল্টার করার জন্য, আপনি একটি ক্যোয়ারী তৈরি করার সময় একটি অর্ডার-বাই পদ্ধতির সাথে সীমা বা পরিসরের যে কোনো পদ্ধতি একত্রিত করতে পারেন।

অর্ডার-বাই পদ্ধতির বিপরীতে, আপনি একাধিক সীমা বা পরিসর ফাংশন একত্রিত করতে পারেন। উদাহরণস্বরূপ, আপনি ফলাফলগুলিকে একটি নির্দিষ্ট মানের পরিসরে সীমাবদ্ধ করতে startAt() এবং endAt() পদ্ধতিগুলিকে একত্রিত করতে পারেন।

এমনকি যখন ক্যোয়ারীটির জন্য শুধুমাত্র একটি মিল থাকে, তখনও স্ন্যাপশটটি একটি তালিকা; এটা শুধু একটি আইটেম রয়েছে. আইটেমটি অ্যাক্সেস করতে, আপনাকে ফলাফলটি লুপ করতে হবে:

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        for (postSnapshot in dataSnapshot.children) {
            // TODO: handle the post
        }
    }

    override fun onCancelled(databaseError: DatabaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException())
        // ...
    }
})
QueryActivity.kt

// My top posts by number of stars
myTopPostsQuery.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot dataSnapshot) {
        for (DataSnapshot postSnapshot: dataSnapshot.getChildren()) {
            // TODO: handle the post
        }
    }

    @Override
    public void onCancelled(@NonNull DatabaseError databaseError) {
        // Getting Post failed, log a message
        Log.w(TAG, "loadPost:onCancelled", databaseError.toException());
        // ...
    }
});
QueryActivity.java

ফলাফলের সংখ্যা সীমিত করুন

আপনি একটি প্রদত্ত কলব্যাকের জন্য সর্বাধিক সংখ্যক শিশুকে সিঙ্ক করতে সেট করতে limitToFirst() এবং limitToLast() পদ্ধতিগুলি ব্যবহার করতে পারেন৷ উদাহরণস্বরূপ, যদি আপনি 100-এর সীমা সেট করতে limitToFirst() ব্যবহার করেন, আপনি প্রাথমিকভাবে শুধুমাত্র 100টি পর্যন্ত onChildAdded() কলব্যাক পাবেন। আপনার ফায়ারবেস ডাটাবেসে 100টিরও কম আইটেম সংরক্ষিত থাকলে, প্রতিটি আইটেমের জন্য একটি onChildAdded() কলব্যাক চালু হয়।

আইটেমগুলি পরিবর্তন হওয়ার সাথে সাথে, আপনি ক্যোয়ারী প্রবেশ করা আইটেমগুলির জন্য onChildAdded() কলব্যাক এবং এটি থেকে বাদ পড়া আইটেমগুলির জন্য onChildRemoved() কলব্যাক পাবেন যাতে মোট সংখ্যা 100-এ থাকে৷

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে উদাহরণ ব্লগিং অ্যাপটি সমস্ত ব্যবহারকারীদের দ্বারা 100টি সাম্প্রতিক পোস্টের একটি তালিকা পুনরুদ্ধার করার জন্য একটি প্রশ্নকে সংজ্ঞায়িত করে:

// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys.
databaseReference.child("posts").limitToFirst(100)
QueryActivity.kt

// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys
Query recentPostsQuery = databaseReference.child("posts")
        .limitToFirst(100);
QueryActivity.java

এই উদাহরণটি শুধুমাত্র একটি ক্যোয়ারীকে সংজ্ঞায়িত করে, আসলে ডেটা সিঙ্ক্রোনাইজ করার জন্য এটির একটি সংযুক্ত শ্রোতা থাকা প্রয়োজন।

কী বা মান দ্বারা ফিল্টার করুন

প্রশ্নগুলির জন্য নির্বিচারে শুরু, শেষ এবং সমতুল্য পয়েন্টগুলি বেছে নিতে আপনি startAt() , startAfter() , endAt() , endBefore() , এবং equalTo() ব্যবহার করতে পারেন। এটি ডেটা পেজিনেট করার জন্য বা শিশুদের সাথে আইটেম খুঁজে বের করার জন্য দরকারী হতে পারে যেগুলির একটি নির্দিষ্ট মান রয়েছে৷

কিভাবে কোয়েরি ডেটা অর্ডার করা হয়

এই বিভাগটি ব্যাখ্যা করে যে কিভাবে Query ক্লাসের প্রতিটি ক্রম অনুসারে পদ্ধতি দ্বারা ডেটা সাজানো হয়।

orderByChild

orderByChild() ব্যবহার করার সময়, নির্দিষ্ট চাইল্ড কী ধারণ করে এমন ডেটা নিম্নরূপ সাজানো হয়:

1. নির্দিষ্ট চাইল্ড কী-এর জন্য একটি null মান সহ শিশুরা প্রথমে আসে।
2. নির্দিষ্ট চাইল্ড কী-এর জন্য false এর মান সহ শিশু পরবর্তী আসে। যদি একাধিক শিশুর false মান থাকে, তাহলে সেগুলোকে কী দ্বারা অভিধানিকভাবে সাজানো হয়।
3. নির্দিষ্ট চাইল্ড কী-এর জন্য true মান সহ শিশু পরবর্তী আসে। যদি একাধিক বাচ্চাদের true মান থাকে, তবে সেগুলি কী দ্বারা অভিধানিকভাবে সাজানো হয়।
4. একটি সাংখ্যিক মান সহ বাচ্চারা পরবর্তীতে আসে, আরোহী ক্রমে সাজানো হয়। যদি নির্দিষ্ট চাইল্ড নোডের জন্য একাধিক বাচ্চার সংখ্যাগত মান একই থাকে, তবে সেগুলি কী দ্বারা বাছাই করা হয়।
5. স্ট্রিংগুলি সংখ্যার পরে আসে এবং আভিধানিকভাবে ঊর্ধ্বক্রম অনুসারে সাজানো হয়। যদি নির্দিষ্ট চাইল্ড নোডের জন্য একাধিক বাচ্চার মান একই থাকে, তবে তাদের কী দ্বারা অভিধানিকভাবে আদেশ করা হয়।
6. অবজেক্টগুলি শেষের দিকে আসে এবং ঊর্ধ্বক্রম অনুসারে কী দ্বারা অভিধানিকভাবে সাজানো হয়।

orderByKey

আপনার ডেটা সাজানোর জন্য orderByKey() ব্যবহার করার সময়, কী দ্বারা ডেটা ক্রমবর্ধমান ক্রমে ফেরত দেওয়া হয়।

1. 32-বিট পূর্ণসংখ্যা হিসাবে পার্স করা যেতে পারে এমন একটি কী সহ বাচ্চারা প্রথমে আসে, আরোহী ক্রমে সাজানো হয়।
2. একটি স্ট্রিং মান সহ বাচ্চারা তাদের কী হিসাবে পরবর্তী আসে, লেক্সিকোগ্রাফিকভাবে আরোহী ক্রমে সাজানো হয়।

orderByValue

orderByValue() ব্যবহার করার সময়, বাচ্চাদের তাদের মান অনুসারে অর্ডার করা হয়। অর্ডার করার মানদণ্ড orderByChild() এর মতোই, নোডের মানটি একটি নির্দিষ্ট চাইল্ড কী-এর মানের পরিবর্তে ব্যবহার করা ছাড়া।

পরবর্তী পদক্ষেপ

• তথ্য গঠন কিভাবে শিখুন
• অফলাইনে ডেটা সঞ্চয় করুন