Android पर Cloud Storage के साथ फ़ाइल मेटाडेटा का इस्तेमाल करना

Cloud Storage रेफ़रंस में फ़ाइल अपलोड करने के बाद, फ़ाइल का मेटाडेटा भी देखा और अपडेट किया जा सकता है. उदाहरण के लिए, कॉन्टेंट टाइप देखने या अपडेट करने के लिए. Files, फ़ाइल के अतिरिक्त मेटाडेटा के साथ कस्टम की/वैल्यू पेयर भी सेव कर सकती है.

ध्यान दें: डिफ़ॉल्ट रूप से, Cloud Storage for Firebase बकेट के डेटा या फ़ाइलों पर कोई कार्रवाई करने के लिए, Firebase Authentication को अनुमति की ज़रूरत होती है. कुछ खास मामलों में, पुष्टि किए बिना ऐक्सेस करने की अनुमति देने के लिए, Firebase Security Rules को Cloud Storage में बदला जा सकता है. हालांकि, ज़्यादातर मामलों में, हमारा सुझाव है कि आप ऐक्सेस पर पाबंदी लगाएं और सुरक्षा के सख्त नियम सेट अप करें. ऐसा खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए करें. ध्यान दें कि अगर Google App Engine का इस्तेमाल किया जाता है और आपके पास *.appspot.com नाम वाले फ़ॉर्मैट वाली डिफ़ॉल्ट Cloud Storage बकेट है, तो आपको यह देखना पड़ सकता है कि आपके सुरक्षा नियम, App Engine फ़ाइलों के ऐक्सेस पर कैसे असर डालते हैं.

फ़ाइल का मेटाडेटा पाना

फ़ाइल मेटाडेटा में name, size, और contentType (जिसे अक्सर MIME टाइप कहा जाता है) जैसी सामान्य प्रॉपर्टी के साथ-साथ, contentDisposition और timeCreated जैसी कुछ कम सामान्य प्रॉपर्टी भी शामिल होती हैं. इस मेटाडेटा को getMetadata() तरीके का इस्तेमाल करके, Cloud Storage रेफ़रंस से वापस पाया जा सकता है.

Kotlin+KTX

// 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!
}
StorageActivity.kt

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!
    }
});
StorageActivity.java

फ़ाइल का मेटाडेटा अपडेट करना

फ़ाइल अपलोड होने के बाद, updateMetadata() तरीके का इस्तेमाल करके, फ़ाइल का मेटाडेटा कभी भी अपडेट किया जा सकता है. किन प्रॉपर्टी को अपडेट किया जा सकता है, इस बारे में ज़्यादा जानकारी के लिए पूरी सूची देखें. मेटाडेटा में बताई गई प्रॉपर्टी ही अपडेट की जाती हैं. बाकी सभी प्रॉपर्टी में कोई बदलाव नहीं किया जाता.

Kotlin+KTX

// 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!
}
StorageActivity.kt

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!
            }
        });
StorageActivity.java

null को पास करके, लिखने लायक मेटाडेटा प्रॉपर्टी मिटाई जा सकती हैं:

Kotlin+KTX

// 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!
}
StorageActivity.kt

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!
            }
        });
StorageActivity.java

गड़बड़ियां ठीक करना

मेटाडेटा पाने या अपडेट करने पर गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल मौजूद न होना या उपयोगकर्ता के पास अपनी पसंद की फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानकारी पाने के लिए, दस्तावेज़ों के गड़बड़ियों को मैनेज करें सेक्शन पर जाएं.

कस्टम मेटाडेटा

StorageMetadata.Builder क्लास में setCustomMetadata() तरीके का इस्तेमाल करके, कस्टम मेटाडेटा तय किया जा सकता है.

Kotlin+KTX

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

Java

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

कस्टम मेटाडेटा में, हर फ़ाइल के लिए ऐप्लिकेशन से जुड़ा डेटा सेव किया जा सकता है. हालांकि, हमारा सुझाव है कि इस तरह के डेटा को सेव और सिंक करने के लिए, किसी डेटाबेस (जैसे कि Firebase Realtime Database) का इस्तेमाल करें.

फ़ाइल मेटाडेटा प्रॉपर्टी

किसी फ़ाइल में मौजूद मेटाडेटा प्रॉपर्टी की पूरी सूची यहां दी गई है:

प्रॉपर्टी गैटर	टाइप	सेटर मौजूद है
getBucket	String	नहीं
getGeneration	String	नहीं
getMetadataGeneration	String	नहीं
getPath	String	नहीं
getName	String	नहीं
getSizeBytes	long	नहीं
getCreationTimeMillis	long	नहीं
getUpdatedTimeMillis	long	नहीं
getMd5Hash	String	नहीं
getCacheControl	String	YES
getContentDisposition	String	YES
getContentEncoding	String	YES
getContentLanguage	String	YES
getContentType	String	YES
getCustomMetadata	String	YES
getCustomMetadataKeys	Set<String>	नहीं

फ़ाइलों को अपलोड करना, डाउनलोड करना, और अपडेट करना ज़रूरी है. हालांकि, उन्हें हटाना भी उतना ही ज़रूरी है. आइए, Cloud Storage से फ़ाइलें मिटाने का तरीका जानें.