Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini de alıp güncelleyebilirsiniz (örneğin, içerik türünü güncellemek için). Dosyalar, ek dosya meta verileriyle birlikte özel anahtar/değer çiftlerini de depolayabilir.
Dosya Meta Verilerini Alma
Dosya meta verileri, contentDisposition
ve timeCreated
gibi daha az kullanılan bazı ö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, metadataWithCompletion:
yöntemi kullanılarak bir Cloud Storage referansından alınabilir.
Swift
// Create reference to the file whose metadata we want to retrieve let forestRef = storageRef.child("images/forest.jpg") // Get metadata properties do { let metadata = try await forestRef.getMetadata() } catch { // ... }
Objective-C
// Create reference to the file whose metadata we want to retrieve FIRStorageReference *forestRef = [storageRef child:@"images/forest.jpg"]; // Get metadata properties [forestRef metadataWithCompletion:^(FIRStorageMetadata *metadata, NSError *error) { if (error != nil) { // Uh-oh, an error occurred! } else { // Metadata now contains the metadata for 'images/forest.jpg' } }];
Dosya Meta Verilerini Güncelleme
Dosya yükleme işlemi tamamlandıktan sonra, istediğiniz zaman updateMetadata:withCompletion:
yöntemini kullanarak dosya meta verilerini güncelleyebilirsiniz. Hangi özelliklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta veride belirtilen özellikler güncellenir, diğer tüm özellikler değiştirilmeden bırakılır.
Swift
// Create reference to the file whose metadata we want to change let forestRef = storageRef.child("images/forest.jpg") // Create file metadata to update let newMetadata = StorageMetadata() newMetadata.cacheControl = "public,max-age=300" newMetadata.contentType = "image/jpeg" // Update metadata properties do { let updatedMetadata = try await forestRef.updateMetadata(newMetadata) } catch { // ... }
Objective-C
// Create reference to the file whose metadata we want to change FIRStorageReference *forestRef = [storageRef child:@"images/forest.jpg"]; // Create file metadata to update FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init]; newMetadata.cacheControl = @"public,max-age=300"; newMetadata.contentType = @"image/jpeg"; // Update metadata properties [forestRef updateMetadata:newMetadata completion:^(FIRStorageMetadata *metadata, NSError *error){ if (error != nil) { // Uh-oh, an error occurred! } else { // Updated metadata for 'images/forest.jpg' is returned } }];
Yazılabilir meta veri özelliklerini nil
değerine ayarlayarak silebilirsiniz:
Objective-C
FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init]; newMetadata.contentType = nil; // Delete the metadata property [forestRef updateMetadata:newMetadata completion:^(FIRStorageMetadata *metadata, NSError *error){ if (error != nil) { // Uh-oh, an error occurred! } else { // metadata.contentType should be nil } }];
Swift
let newMetadata = StorageMetadata() newMetadata.contentType = nil do { // Delete the metadata property let updatedMetadata = try await forestRef.updateMetadata(newMetadata) } catch { // ... }
Hataları Giderme
Meta veri alınırken veya güncellenirken, dosyanın mevcut olmaması ya da kullanıcının istenen dosyaya erişim izninin olmaması gibi çeşitli nedenler vardır. Hatalar hakkında daha fazla bilgiyi belgelerin İşleyici Hataları bölümünde bulabilirsiniz.
Özel Meta Veriler
Özel meta verileri, NSString
özelliklerini içeren bir NSDictionary
olarak belirtebilirsiniz.
Swift
let metadata = [ "customMetadata": [ "location": "Yosemite, CA, USA", "activity": "Hiking" ] ]
Objective-C
NSDictionary *metadata = @{ @"customMetadata": @{ @"location": @"Yosemite, CA, USA", @"activity": @"Hiking" } };
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 Realtime Database gibi) kullanmanızı önemle tavsiye ederiz.
Dosya Meta Verisi Özellikleri
Bir dosyadaki meta veri özelliklerinin tam listesini aşağıda bulabilirsiniz:
Özellik | Tür | Yazılabilir |
---|---|---|
bucket |
Dize | Hayır |
generation |
Dize | Hayır |
metageneration |
Dize | Hayır |
fullPath |
Dize | Hayır |
name |
Dize | Hayır |
size |
Int64 | Hayır |
timeCreated |
Tarih | Hayır |
updated |
Tarih | Hayır |
md5Hash |
Dize | Evet |
cacheControl |
Dize | Evet |
contentDisposition |
Dize | Evet |
contentEncoding |
Dize | Evet |
contentLanguage |
Dize | Evet |
contentType |
Dize | Evet |
customMetadata |
[Dize: Dize] | Evet |
Dosya yüklemek, indirmek ve güncellemek önemlidir ancak bunları kaldırabilmek de önemlidir. Şimdi Cloud Storage'dan dosya silme işlemini nasıl yapacağınızı öğrenelim.