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

ফায়ারবেসের জন্য ক্লাউড স্টোরেজ আপনাকে আপনার ক্লাউড স্টোরেজ বাকেটের বিষয়বস্তু তালিকাভুক্ত করতে দেয়। 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 থাকে বা /. . উদাহরণস্বরূপ, একটি বালতি বিবেচনা করুন যাতে নিম্নলিখিত বস্তু রয়েছে:

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

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

  • মূলে তালিকার ক্রিয়াকলাপ correctPrefix , wrongPrefix এবং lonelyItem এর রেফারেন্সগুলিকে prefixes হিসাবে প্রদান করে।
  • correctPrefix/ এ তালিকার ক্রিয়াকলাপ items হিসাবে correctPrefix/happyItem এর রেফারেন্স প্রদান করে।
  • wrongPrefix/ -এ তালিকা অপারেশন কোনো রেফারেন্স ফেরত দেয় না কারণ wrongPrefix//sadItem পরপর দুটি / s থাকে।
  • 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 {
  // ...
}

উদ্দেশ্য গ

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.
  }
}];

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

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)
  }
}

উদ্দেশ্য গ

- (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];
  }
}

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

আপনি যদি আপনার নিরাপত্তা বিধিগুলিকে সংস্করণ 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.

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