Apple platformlarında Cloud Storage ile dosya meta verilerini kullanma

Cloud Storage referansına dosya yükledikten sonra şunu da alabilirsiniz: ve dosya meta verilerini güncelleyin (örneğin, içerik türünü güncellemek için). Dosyalar özel anahtar/değer çiftlerini ek dosya meta verileriyle birlikte de depolayabilir.

Dosya Meta Verilerini Alma

Dosya meta verileri name, size ve contentType (genellikle MIME türü olarak adlandırılır) ve daha az contentDisposition ve timeCreated gibi yaygın örnekler. Bu meta veri, Cloud Storage referansından alındı: metadataWithCompletion: yöntemi.

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 meta verilerini, dosya yüklemesi tamamlandıktan sonra istediğiniz zaman (updateMetadata:withCompletion: yöntemini kullanarak). Daha fazla bilgi için özellikleri hakkında daha fazla bilgi için tam listeye güncellenebilir. Yalnızca meta veride belirtilen özellikler güncellenir, diğer tüm değişiklikler 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

Bilgileri alma veya güncelleme sırasında hataların oluşmasının birkaç nedeni vardır: mevcut olmayan veya kullanıcının izni olmayan kullanıcı da dahil olmak üzere meta veriler istediğiniz dosyaya erişin. Hatalarla ilgili daha fazla bilgiyi şurada bulabilirsiniz: Hataları İşleme bölümünde bulabilirsiniz.

Özel Meta Veriler

Özel meta verileri, NSString içeren bir NSDictionary olarak belirtebilirsiniz. özellikler.

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 saklayabilirsiniz. Ancak bir veritabanı (örneğin, Firebase Realtime Database) kullanın ve bu veri türünü senkronize edin dışı verilerdir.

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 tıklayın. Şimdi nasıl uygulayacağımızı dosyaları sil Cloud Storage'dan edinilebilir.