Android'de Cloud Storage ile dosya meta verilerini kullanma

Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini de alıp güncelleyebilirsiniz (ör. içerik türünü görüntülemek veya güncellemek için). Dosyalar, ek dosya meta verileriyle özel anahtar/değer çiftleri de depolayabilir.

Dosya meta verilerini alma

Dosya meta verileri, contentDisposition ve timeCreated gibi daha az yaygın olan özelliklerin yanı sıra name, size ve contentType (genellikle MIME türü olarak adlandırılır) gibi yaygın özellikleri içerir. Bu meta veriler, getMetadata() yöntemi kullanılarak bir Cloud Storage referansından alınabilir.

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

Dosya meta verilerini güncelleme

Dosya yükleme işlemi tamamlandıktan sonra updateMetadata() yöntemini kullanarak dosya meta verilerini istediğiniz zaman güncelleyebilirsiniz. Hangi özelliklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta verilerde belirtilen özellikler güncellenir, diğer tüm özellikler değiştirilmeden bırakılır.

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 ile yazılabilir meta veri özelliklerini silebilirsiniz:

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

Hataları işleme

Meta verileri alma veya güncelleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Örneğin, dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişme izninin olmaması bu nedenler arasındadır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları ele alma bölümünde bulabilirsiniz.

Özel Meta Veriler

StorageMetadata.Builder sınıfındaki setCustomMetadata() yöntemini kullanarak özel meta veriler belirtebilirsiniz.

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

Her dosyanın uygulamaya özgü verilerini özel meta verilerde saklayabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (ör. Firebase Realtime Database) kullanmanızı önemle tavsiye ederiz.

Dosya Meta Veri Özellikleri

Bir dosyadaki meta veri özelliklerinin tam listesini aşağıda bulabilirsiniz:

Mülk alıcı Tür Ayarlayıcı Var
getBucket String HAYIR
getGeneration String HAYIR
getMetadataGeneration String HAYIR
getPath String HAYIR
getName String HAYIR
getSizeBytes long HAYIR
getCreationTimeMillis long HAYIR
getUpdatedTimeMillis long HAYIR
getMd5Hash String HAYIR
getCacheControl String EVET
getContentDisposition String EVET
getContentEncoding String EVET
getContentLanguage String EVET
getContentType String EVET
getCustomMetadata String EVET
getCustomMetadataKeys Set<String> HAYIR

Dosya yükleme, indirme ve güncelleme kadar dosyaları kaldırabilmek de önemlidir. Cloud Storage'den dosyaları nasıl sileceğinizi öğrenelim.