আপনার ফাইলগুলি একটি Cloud Storage বালতিতে সংরক্ষণ করা হয়৷ আপনার স্থানীয় হার্ড ডিস্কের ফাইল সিস্টেম বা Firebase Realtime Database ডেটার মতো এই বাকেটের ফাইলগুলি একটি শ্রেণিবদ্ধ কাঠামোতে উপস্থাপিত হয়। একটি ফাইলের একটি রেফারেন্স তৈরি করে, আপনার অ্যাপ এটিতে অ্যাক্সেস লাভ করে। এই রেফারেন্সগুলি তারপরে ডেটা আপলোড বা ডাউনলোড করতে, মেটাডেটা পেতে বা আপডেট করতে বা ফাইলটি মুছতে ব্যবহার করা যেতে পারে। একটি রেফারেন্স হয় একটি নির্দিষ্ট ফাইল বা অনুক্রমের একটি উচ্চ স্তরের নোড নির্দেশ করতে পারে।
আপনি যদি Firebase Realtime Database ব্যবহার করে থাকেন তবে এই পথগুলি আপনার কাছে খুব পরিচিত বলে মনে হবে। যাইহোক, আপনার ফাইলের ডেটা Cloud Storage সংরক্ষণ করা হয়, Realtime Database নয় ।
একটি রেফারেন্স তৈরি করুন
একটি ফাইল আপলোড, ডাউনলোড বা মুছে ফেলার জন্য বা এর মেটাডেটা পেতে বা আপডেট করতে একটি রেফারেন্স তৈরি করুন৷ একটি রেফারেন্স ক্লাউডে একটি ফাইলের একটি পয়েন্টার হিসাবে চিন্তা করা যেতে পারে। রেফারেন্সগুলি হালকা, তাই আপনি যতগুলি প্রয়োজন ততগুলি তৈরি করতে পারেন৷ এগুলি একাধিক অপারেশনের জন্য পুনরায় ব্যবহারযোগ্য।
আপনার Firebase অ্যাপে Firebase.Storage.FirebaseStorage
পরিষেবা থেকে GetReferenceFromUrl()
পদ্ধতিতে কল করে এবং gs://<your-cloud-storage-bucket>
ফর্মের একটি URL দিয়ে রেফারেন্স তৈরি করা হয়। আপনি Firebase কনসোলের স্টোরেজ বিভাগে এই URLটি খুঁজে পেতে পারেন।
// Get a reference to the storage service, using the default Firebase App FirebaseStorage storage = FirebaseStorage.DefaultInstance; // Create a storage reference from our storage service StorageReference storageRef = storage.GetReferenceFromUrl("gs://<your-cloud-storage-bucket>");
বিদ্যমান রেফারেন্সে child
মেথড ব্যবহার করে আপনি গাছের নিচের অবস্থানের জন্য একটি রেফারেন্স তৈরি করতে পারেন, উদাহরণস্বরূপ 'images/space.jpg'
।
// Create a child reference // imagesRef now points to "images" StorageReference imagesRef = storageRef.Child("images"); // Child references can also take paths delimited by '/' such as: // "images/space.jpg". StorageReference spaceRef = imagesRef.Child("space.jpg"); // spaceRef now points to "images/space.jpg" // imagesRef still points to "images" // This is equivalent to creating the full referenced StorageReference spaceRefFull = storage.GetReferenceFromUrl( "gs://<your-cloud-storage-bucket>/images/space.jpg");
রেফারেন্স দিয়ে নেভিগেট করুন
আপনি আমাদের ফাইলের অনুক্রমে নেভিগেট করার জন্য Parent
এবং Root
পদ্ধতিগুলিও ব্যবহার করতে পারেন। Parent
একটি স্তরের উপরে নেভিগেট করে, যখন Root
শীর্ষে সমস্ত পথ নেভিগেট করে।
// Parent allows us to move to the parent of a reference // imagesRef now points to 'images' StorageReference imagesRef = spaceRef.Parent; // Root allows us to move all the way back to the top of our bucket // rootRef now points to the root StorageReference rootRef = spaceRef.Root;
Child
, Parent
, এবং Root
একাধিকবার একসাথে শৃঙ্খলিত হতে পারে, কারণ প্রতিটি একটি রেফারেন্স প্রদান করে। ব্যতিক্রম হল Root
এর Parent
, যা একটি অবৈধ StorageReference
।
// References can be chained together multiple times // earthRef points to "images/earth.jpg" StorageReference earthRef = spaceRef.Parent.Child("earth.jpg"); // nullRef is null since the parent of root is an invalid StorageReference StorageReference nullRef = spaceRef.Root.Parent;
রেফারেন্স পদ্ধতি
Path
, Name
, এবং Bucket
বৈশিষ্ট্যগুলি ব্যবহার করে তারা যে ফাইলগুলি নির্দেশ করে তা আরও ভালভাবে বোঝার জন্য আপনি রেফারেন্সগুলি পরীক্ষা করতে পারেন৷ এই বৈশিষ্ট্যগুলি ফাইলের সম্পূর্ণ পথ, নাম এবং বালতি পায়।
// Reference's path is: "images/space.jpg" // This is analogous to a file path on disk string path = spaceRef.Path; // Reference's name is the last segment of the full path: "space.jpg" // This is analogous to the file name string name = spaceRef.Name; // Reference's bucket is the name of the storage bucket where files are stored string bucket = spaceRef.Bucket;
রেফারেন্সের সীমাবদ্ধতা
রেফারেন্স পাথ এবং নামগুলিতে বৈধ ইউনিকোড অক্ষরের যেকোনো ক্রম থাকতে পারে, তবে কিছু বিধিনিষেধ আরোপ করা হয়েছে যার মধ্যে রয়েছে:
-
reference.Path
মোট দৈর্ঘ্য। UTF-8 এনকোড করার সময় পাথ অবশ্যই 1 থেকে 1024 বাইটের মধ্যে হতে হবে। - কোনো ক্যারেজ রিটার্ন বা লাইন ফিড অক্ষর নেই।
-
#
,[
,]
,*
, বা?
, কারণ এগুলো অন্যান্য টুল যেমন Firebase Realtime Database বা gsutil-এর সাথে ভাল কাজ করে না।
সম্পূর্ণ উদাহরণ
FirebaseStorage storage = FirebaseStorage.DefaultInstance; // Points to the root reference StorageReference storageRef = storage.GetReferenceFromUrl("gs://<your-bucket-name>"); // Points to "images" StorageReference imagesRef = storageRef.Child("images"); // Points to "images/space.jpg" // Note that you can use variables to create child values string filename = "space.jpg"; StorageReference spaceRef = imagesRef.Child(filename); // File path is "images/space.jpg" string path = spaceRef.Path; // File name is "space.jpg" string name = spaceRef.Name; // Points to "images" StorageReference imagesRef = spaceRef.Parent;
পরবর্তী পদক্ষেপ
এর পরে, আসুন শিখি কিভাবে Cloud Storage ফাইল আপলোড করতে হয়।