ফ্লটারে ক্লাউড স্টোরেজ সহ ফাইল তালিকাভুক্ত করুন

ফায়ারবেসের জন্য ক্লাউড স্টোরেজ আপনাকে আপনার ক্লাউড স্টোরেজ বাকেটের বিষয়বস্তু তালিকাভুক্ত করতে দেয়। SDK বর্তমান ক্লাউড স্টোরেজ রেফারেন্সের অধীনে আইটেম এবং অবজেক্টের উপসর্গ উভয়ই ফেরত দেয়।

যে প্রকল্পগুলি তালিকা API ব্যবহার করে তাদের Firebase নিয়ম সংস্করণ 2-এর জন্য ক্লাউড স্টোরেজ প্রয়োজন। আপনার যদি একটি বিদ্যমান ফায়ারবেস প্রকল্প থাকে, তাহলে নিরাপত্তা বিধি নির্দেশিকাতে দেওয়া ধাপগুলি অনুসরণ করুন।

list() Google ক্লাউড স্টোরেজ লিস্ট API ব্যবহার করে। Firebase-এর জন্য ক্লাউড স্টোরেজ-এ, আমরা / একটি বিভাজনকারী হিসেবে ব্যবহার করি, যা আমাদের ফাইল সিস্টেমের শব্দার্থ অনুকরণ করতে দেয়। বৃহৎ, শ্রেণিবদ্ধ ক্লাউড স্টোরেজ বালতিগুলির দক্ষ ট্রাভার্সালের অনুমতি দিতে, তালিকা API উপসর্গ এবং আইটেমগুলিকে আলাদাভাবে প্রদান করে। উদাহরণস্বরূপ, যদি আপনি একটি ফাইল আপলোড করেন /images/uid/file1 ,

• root.child('images').listAll() একটি উপসর্গ হিসাবে /images/uid প্রদান করবে।
• root.child('images/uid').listAll() ফাইলটিকে একটি আইটেম হিসাবে ফিরিয়ে দেবে।

Firebase SDK-এর জন্য ক্লাউড স্টোরেজ এমন অবজেক্ট পাথ ফেরত দেয় না যেখানে পরপর দুটি / s থাকে বা a / দিয়ে শেষ হয়। উদাহরণস্বরূপ, একটি বালতি বিবেচনা করুন যাতে নিম্নলিখিত বস্তু রয়েছে:

• correctPrefix/happyItem
• wrongPrefix//sadItem
• lonelyItem/

এই বালতিতে থাকা আইটেমগুলির তালিকার ক্রিয়াকলাপগুলি নিম্নলিখিত ফলাফলগুলি দেবে:

• মূলে তালিকার ক্রিয়াকলাপ correctPrefix , wrongPrefix এবং lonelyItem এর রেফারেন্সগুলিকে prefixes হিসাবে প্রদান করে।
• correctPrefix/ এ তালিকার ক্রিয়াকলাপ items হিসাবে correctPrefix/happyItem এর রেফারেন্স প্রদান করে।
• wrongPrefix/ -এ তালিকা অপারেশন কোনো রেফারেন্স ফেরত দেয় না কারণ wrongPrefix//sadItem পরপর দুটি / s থাকে।
• lonelyItem/ -এ লিস্ট অপারেশন কোনো রেফারেন্স ফেরত দেয় না কারণ অবজেক্ট lonelyItem/ / শেষ হয়।

সমস্ত ফাইল তালিকা

আপনি একটি ডিরেক্টরির জন্য সমস্ত ফলাফল আনতে listAll ব্যবহার করতে পারেন। এটি ছোট ডিরেক্টরির জন্য সবচেয়ে ভাল ব্যবহার করা হয় কারণ সমস্ত ফলাফল মেমরিতে বাফার করা হয়। প্রক্রিয়া চলাকালীন বস্তুগুলি যোগ করা বা সরানো হলে অপারেশনটি একটি সামঞ্জস্যপূর্ণ স্ন্যাপশট ফেরত নাও দিতে পারে।

একটি বড় তালিকার জন্য, তালিকাভুক্ত list() পদ্ধতিটি ব্যবহার করুন কারণ listAll() মেমরিতে সমস্ত ফলাফল বাফার করে।

নিম্নলিখিত উদাহরণটি প্রদর্শন করে listAll .

final storageRef = FirebaseStorage.instance.ref().child("files/uid");
final listResult = await storageRef.listAll();
for (var prefix in listResult.prefixes) {
  // The prefixes under storageRef.
  // You can call listAll() recursively on them.
}
for (var item in listResult.items) {
  // The items under storageRef.
}

পৃষ্ঠা সংখ্যা তালিকা ফলাফল

list() API ফলাফলের সংখ্যার উপর একটি সীমা রাখে। list() একটি সামঞ্জস্যপূর্ণ পৃষ্ঠাদর্শন প্রদান করে এবং একটি পেজটোকেন প্রকাশ করে যা কখন অতিরিক্ত ফলাফল আনতে হবে তা নিয়ন্ত্রণ করতে দেয়।

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

নিম্নোক্ত উদাহরণটি একটি ফলাফলের পৃষ্ঠা সংখ্যা প্রদর্শন করে:

Stream<ListResult> listAllPaginated(Reference storageRef) async* {
  String? pageToken;
  do {
    final listResult = await storageRef.list(ListOptions(
      maxResults: 100,
      pageToken: pageToken,
    ));
    yield listResult;
    pageToken = listResult.nextPageToken;
  } while (pageToken != null);
}

ত্রুটিগুলি পরিচালনা করুন

list() এবং listAll() ব্যর্থ হয় যদি আপনি নিরাপত্তা বিধিগুলিকে সংস্করণ 2-এ আপগ্রেড না করে থাকেন। যদি আপনি এই ত্রুটিটি দেখতে পান আপনার নিরাপত্তা নিয়ম আপগ্রেড করুন:

Listing objects in a bucket is disallowed for rules_version = "1".
Please update storage security rules to rules_version = "2" to use list.

অন্যান্য সম্ভাব্য ত্রুটিগুলি নির্দেশ করতে পারে যে ব্যবহারকারীর সঠিক অনুমতি নেই। ত্রুটি সম্পর্কে আরও তথ্য হ্যান্ডেল ত্রুটি পৃষ্ঠায় পাওয়া যাবে।