Menggunakan Metadata File di Android

Setelah mengupload file ke referensi Cloud Storage, Anda juga dapat mengambil dan mengupdate metadata file, misalnya untuk melihat atau mengupdate jenis konten. File juga dapat menyimpan key-value pair khusus dengan metadata file tambahan.

Mengambil Metadata File

Metadata file berisi properti umum, seperti name, size, dan contentType (sering disebut jenis MIME), serta beberapa properti yang jarang digunakan, seperti contentDisposition dan timeCreated. Metadata ini dapat diambil dari referensi Cloud Storage menggunakan metode getMetadata().

Java
Android

// 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!
    }
});

Kotlin
Android

// 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 now contains the metadata for 'images/forest.jpg'
}.addOnFailureListener {
    // Uh-oh, an error occurred!
}

Mengupdate Metadata File

Anda dapat mengupdate metadata file kapan saja setelah file terupload sepenuhnya menggunakan metode updateMetadata(). Lihat daftar lengkap untuk mengetahui informasi lebih lanjut mengenai properti yang dapat diupdate. Hanya properti yang ditetapkan dalam metadata yang akan diupdate, sedangkan yang lainnya tidak berubah.

Java
Android

// 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!
            }
        });

Kotlin
Android

// 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.Builder()
        .setContentType("image/jpg")
        .setCustomMetadata("myCustomProperty", "myValue")
        .build()

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

Anda dapat menghapus properti metadata yang dapat ditulis dengan meneruskan null:

Java
Android

// 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!
            }
        });

Kotlin
Android

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

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

Menangani Error

Ada sejumlah alasan mengapa error dapat terjadi saat mengambil atau mengupdate metadata, termasuk tidak adanya file atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut mengenai error bisa dilihat di bagian Menangani Error pada dokumen.

Metadata Kustom

Anda dapat menentukan metadata kustom menggunakan metode setCustomMetadata() pada class StorageMetadata.Builder.

Java
Android

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

Kotlin
Android

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

Anda dapat menyimpan data khusus aplikasi untuk setiap file di metadata kustom, tetapi sebaiknya Anda menggunakan database (seperti Firebase Realtime Database) untuk menyimpan dan menyinkronkan jenis data seperti ini.

Properti Metadata File

Daftar lengkap properti metadata pada file tercantum di bawah ini:

Pengambil Properti Jenis Ada Penyetel
getBucket String TIDAK
getGeneration String TIDAK
getMetadataGeneration String TIDAK
getPath String TIDAK
getName String TIDAK
getSizeBytes long TIDAK
getCreationTimeMillis long TIDAK
getUpdatedTimeMillis long TIDAK
getMd5Hash String TIDAK
getCacheControl String YA
getContentDisposition String YA
getContentEncoding String YA
getContentLanguage String YA
getContentType String YA
getCustomMetadata String YA
getCustomMetadataKeys Set<String> TIDAK

Mengupload, mendownload, dan mengupdate file itu penting, namun kita juga harus bisa menghapusnya. Mari pelajari cara menghapus file dari Cloud Storage.

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.