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

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

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

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

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

Cloud Storage for Firebase এমন অবজেক্ট পাথ ফেরত দেয় না যেখানে পরপর দুটি / s থাকে বা /. . উদাহরণস্বরূপ, একটি বালতি বিবেচনা করুন যাতে নিম্নলিখিত বস্তু রয়েছে:

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

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

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

সব ফাইল তালিকা

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

একটি বৃহৎ তালিকার জন্য, তালিকাভুক্ত list(withMaxResults:completion:) পদ্ধতি ব্যবহার করুন listAll(completion:) মেমরিতে সমস্ত ফলাফল বাফার করে।

নিম্নলিখিত উদাহরণ প্রদর্শন করে listAll(completion:) ।

সুইফট 

let storageReference = storage.reference().child("files/uid")
do {
  let result = try await storageReference.listAll()
  for prefix in result.prefixes {
    // The prefixes under storageReference.
    // You may call listAll(completion:) recursively on them.
  }
  for item in result.items {
    // The items under storageReference.
  }
} catch {
  // ...
}
ViewController.swift

উদ্দেশ্য-C 

FIRStorageReference *storageReference = [storage reference];
[storageReference listAllWithCompletion:^(FIRStorageListResult *result, NSError *error) {
  if (error != nil) {
    // ...
  }

  for (FIRStorageReference *prefix in result.prefixes) {
    // All the prefixes under storageReference.
    // You may call listAllWithCompletion: recursively on them.
  }
  for (FIRStorageReference *item in result.items) {
    // All items under storageReference.
  }
}];
ViewController.m

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

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

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

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

সুইফট 

func listAllPaginated(pageToken: String? = nil) async throws {
  let storage = Storage.storage()
  let storageReference = storage.reference().child("files/uid")

  let listResult: StorageListResult
  if let pageToken = pageToken {
    listResult = try await storageReference.list(maxResults: 100, pageToken: pageToken)
  } else {
    listResult = try await storageReference.list(maxResults: 100)
  }
  let prefixes = listResult.prefixes
  let items = listResult.items
  // Handle list result
  // ...

  // Process next page
  if let token = listResult.pageToken {
    try await listAllPaginated(pageToken: token)
  }
}
ViewController.swift

উদ্দেশ্য-C 

- (void)paginateFilesAtReference:(FIRStorageReference *)reference
                       pageToken:(nullable NSString *)pageToken {
  void (^pageHandler)(FIRStorageListResult *_Nonnull, NSError *_Nullable) =
      ^(FIRStorageListResult *result, NSError *error) {
        if (error != nil) {
          // ...
        }
        NSArray *prefixes = result.prefixes;
        NSArray *items = result.items;

        // ...

        // Process next page
        if (result.pageToken != nil) {
          [self paginateFilesAtReference:reference pageToken:result.pageToken];
        }
  };

  if (pageToken != nil) {
    [reference listWithMaxResults:100 pageToken:pageToken completion:pageHandler];
  } else {
    [reference listWithMaxResults:100 completion:pageHandler];
  }
}
ViewController.m

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

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

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

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