Android'de Cloud Storage ile dosya meta verilerini kullanma

Bir dosyayı Cloud Storage referansına yükledikten sonra, örneğin içerik türünü görüntülemek veya güncellemek için dosya meta verilerini alabilir ve güncelleyebilirsiniz. Dosyalar, ek dosya meta verileriyle birlikte özel anahtar/değer çiftlerini de depolayabilir.

Dosya Meta Verilerini Alın

Dosya meta verileri, name , size ve contentType (genellikle MIME türü olarak adlandırılır) gibi ortak özelliklerin yanı sıra contentDisposition ve timeCreated gibi daha az yaygın olan bazı özellikleri içerir. Bu meta veriler, getMetadata() yöntemi kullanılarak bir Bulut Depolama 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üncelle

Dosya yüklemesi 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ğerleri 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

Yazılabilir meta veri özelliklerini null ileterek 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

İşleme Hataları

Dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişim iznine sahip olmaması da dahil olmak üzere, meta verileri alırken veya güncellerken hataların ortaya çıkmasının birkaç nedeni vardır. Hatalar hakkında daha fazla bilgi, belgelerin Hataları İşle bölümünde bulunabilir.

Özel Meta Veriler

StorageMetadata.Builder sınıfında setCustomMetadata() yöntemini kullanarak özel meta verileri 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 dosya için uygulamaya özel verileri özel meta verilerde depolayabilirsiniz, ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı ( Firebase Gerçek Zamanlı Veritabanı gibi) kullanmanızı kesinlikle öneririz.

Dosya Meta Veri Özellikleri

Bir dosyadaki meta veri özelliklerinin tam listesi aşağıda mevcuttur:

Özellik Alıcısı	Tip	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

Dosyaları yüklemek, indirmek ve güncellemek önemlidir, ancak bunları kaldırabilmek de önemlidir. Cloud Storage'dan dosyaların nasıl silineceğini öğrenelim.