Android-এ Cloud Storage-এর সাথে ফাইল মেটাডেটা ব্যবহার করা

Cloud Storage রেফারেন্সে ফাইল আপলোড করার পরে, আপনি ফাইল মেটাডেটা পেতে ও আপডেট করতে পারবেন, যেমন কন্টেন্টের ধরন দেখা বা আপডেট করা। এছাড়াও, ফাইল অতিরিক্ত ফাইল মেটাডেটার সাথে কাস্টম কী/ভ্যালুর পেয়ার স্টোর করতে পারে।

ফাইলের মেটাডেটা পাওয়া

ফাইলের মেটাডেটায় name, size এবং contentType (সাধারণত MIME টাইপ হিসেবে উল্লেখ করা হয়)-এর মতো সাধারণ প্রপার্টি থাকে, এর সাথে contentDisposition এবং timeCreated-এর মতো কিছু কম সাধারণ প্রপার্টিও থাকে। getMetadata() পদ্ধতি ব্যবহার করে Cloud Storage রেফারেন্স থেকে এই মেটাডেটা ফিরিয়ে আনা যাবে।

Kotlin

// Create a storage reference from our app
val storageRef = storage.reference

// Get reference to the file
val forestRef = storageRef.child("images/forest.jpg")
forestRef.metadata.addOnSuccessListener { metadata ->
    // Metadata now contains the metadata for 'images/forest.jpg'
}.addOnFailureListener {
    // Uh-oh, an error occurred!
}

Java

// Create a storage reference from our app
StorageReference storageRef = storage.getReference();

// Get reference to the file
StorageReference forestRef = storageRef.child("images/forest.jpg");
forestRef.getMetadata().addOnSuccessListener(new OnSuccessListener<StorageMetadata>() {
    @Override
    public void onSuccess(StorageMetadata storageMetadata) {
        // Metadata now contains the metadata for 'images/forest.jpg'
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception exception) {
        // Uh-oh, an error occurred!
    }
});

ফাইলের মেটাডেটা আপডেট করুন

ফাইল আপলোড সম্পূর্ণ হওয়ার পরে যেকোনও সময় updateMetadata() পদ্ধতি ব্যবহার করে আপনি ফাইল মেটাডেটা আপডেট করতে পারবেন। কোন কোন প্রপার্টি আপডেট করা যাবে সেই সম্পর্কে আরও জানতে সম্পূর্ণ তালিকা দেখুন। মেটাডেটায় উল্লেখ করা প্রপার্টিগুলিই শুধু আপডেট করা হয়, বাকিগুলি অপরিবর্তিত থাকে।

Kotlin

// Create a storage reference from our app
val storageRef = storage.reference

// Get reference to the file
val forestRef = storageRef.child("images/forest.jpg")
// Create file metadata including the content type
val metadata = storageMetadata {
    contentType = "image/jpg"
    setCustomMetadata("myCustomProperty", "myValue")
}

// Update metadata properties
forestRef.updateMetadata(metadata).addOnSuccessListener { updatedMetadata ->
    // Updated metadata is in updatedMetadata
}.addOnFailureListener {
    // Uh-oh, an error occurred!
}

Java

// Create a storage reference from our app
StorageReference storageRef = storage.getReference();

// Get reference to the file
StorageReference forestRef = storageRef.child("images/forest.jpg");
// Create file metadata including the content type
StorageMetadata metadata = new StorageMetadata.Builder()
        .setContentType("image/jpg")
        .setCustomMetadata("myCustomProperty", "myValue")
        .build();

// Update metadata properties
forestRef.updateMetadata(metadata)
        .addOnSuccessListener(new OnSuccessListener<StorageMetadata>() {
            @Override
            public void onSuccess(StorageMetadata storageMetadata) {
                // Updated metadata is in storageMetadata
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception exception) {
                // Uh-oh, an error occurred!
            }
        });

null পাস করে আপনি রাইটেবল মেটাডেটা প্রপার্টি মুছে দিতে পারবেন:

Kotlin

// Create file metadata with property to delete
val metadata = storageMetadata {
    contentType = null
}

// Delete the metadata property
forestRef.updateMetadata(metadata).addOnSuccessListener { updatedMetadata ->
    // updatedMetadata.contentType should be null
}.addOnFailureListener {
    // Uh-oh, an error occurred!
}

Java

// Create file metadata with property to delete
StorageMetadata metadata = new StorageMetadata.Builder()
        .setContentType(null)
        .build();

// Delete the metadata property
forestRef.updateMetadata(metadata)
        .addOnSuccessListener(new OnSuccessListener<StorageMetadata>() {
            @Override
            public void onSuccess(StorageMetadata storageMetadata) {
                // metadata.contentType should be null
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception exception) {
                // Uh-oh, an error occurred!
            }
        });

সমস্যা ম্যানেজ করা

মেটাডেটা পাওয়া বা আপডেট করার সময় বিভিন্ন কারণে সমস্যা হতে পারে, যেমন ফাইলটি না থাকা বা ব্যবহারকারীর কাছে কাঙ্ক্ষিত ফাইল অ্যাক্সেস করার অনুমতি না থাকা। সমস্যা সম্পর্কে আরও তথ্য ডকুমেন্টের সমস্যা সমাধান করুন বিভাগে পাওয়া যাবে।

কাস্টম মেটাডেটা

আপনি StorageMetadata.Builder ক্লাসে setCustomMetadata() পদ্ধতি ব্যবহার করে কাস্টম মেটাডেটা নির্দিষ্ট করতে পারেন।

Kotlin

val metadata = storageMetadata {
    setCustomMetadata("location", "Yosemite, CA, USA")
    setCustomMetadata("activity", "Hiking")
}

Java

StorageMetadata metadata = new StorageMetadata.Builder()
        .setCustomMetadata("location", "Yosemite, CA, USA")
        .setCustomMetadata("activity", "Hiking")
        .build();

আপনি কাস্টম মেটাডেটাতে প্রতিটি ফাইলের জন্য অ্যাপ-নির্দিষ্ট ডেটা স্টোর করতে পারেন, তবে আমরা এই ধরনের ডেটা স্টোর এবং সিঙ্ক করার জন্য একটি ডেটাবেস (যেমন Firebase Realtime Database) ব্যবহার করার জন্য অত্যন্ত সাজেস্ট করি।

ফাইল মেটাডেটা প্রপার্টি

ফাইলের মেটাডেটা প্রপার্টির সম্পূর্ণ তালিকা নিচে দেওয়া হল:

প্রপার্টি গেটার প্রকার সেটার আছে
getBucket String নরওয়ে (KO)
getGeneration String নরওয়ে (KO)
getMetadataGeneration String নরওয়ে (KO)
getPath String নরওয়ে (KO)
getName String নরওয়ে (KO)
getSizeBytes long নরওয়ে (KO)
getCreationTimeMillis long নরওয়ে (KO)
getUpdatedTimeMillis long নরওয়ে (KO)
getMd5Hash String নরওয়ে (KO)
getCacheControl String হ্যাঁ
getContentDisposition String হ্যাঁ
getContentEncoding String হ্যাঁ
getContentLanguage String হ্যাঁ
getContentType String হ্যাঁ
getCustomMetadata String হ্যাঁ
getCustomMetadataKeys Set<String> নরওয়ে (KO)

ফাইল আপলোড, ডাউনলোড ও আপডেট করা গুরুত্বপূর্ণ, তবে সেগুলি সরিয়ে দেওয়ার ক্ষমতাও গুরুত্বপূর্ণ। Cloud Storage থেকে কীভাবে ফাইল মুছতে হয় তা জেনে নেওয়া যাক।