Dateimetadaten mit Cloud Storage auf Apple-Plattformen verwenden

Nach dem Hochladen einer Datei in die Cloud Storage Referenz können Sie auch die Dateimetadaten abrufen und aktualisieren, z. B. um den Inhaltstyp zu aktualisieren. In Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten gespeichert werden.

Dateimetadaten abrufen

Dateimetadaten enthalten neben einigen weniger häufigen Attributen wie contentDisposition und timeCreated auch allgemeine Attribute wie name, size und contentType (oft als MIME-Typ bezeichnet). Diese Metadaten können aus einer Cloud Storage Referenz mit der metadataWithCompletion: Methode abgerufen werden.

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'
  }
}];

Dateimetadaten aktualisieren

Sie können die Dateimetadaten jederzeit nach Abschluss des Datei-Uploads mit der Methode updateMetadata:withCompletion: aktualisieren. In der vollständigen Liste finden Sie weitere Informationen zu den Attributen, die aktualisiert werden können. Es werden nur die in den Metadaten angegebenen Attribute aktualisiert. Alle anderen bleiben unverändert.

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
  }
}];

Sie können bearbeitbare Metadatenattribute löschen, indem Sie sie auf nil setzen:

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 {
  // ...
}

Fehlerbehebung

Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten können. Dazu gehören beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung hat, auf die gewünschte Datei zuzugreifen. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehlerbehebung in der Dokumentation.

Benutzerdefinierte Metadaten

Sie können benutzerdefinierte Metadaten als NSDictionary mit NSString-Attributen angeben.

Swift

let metadata = [
  "customMetadata": [
    "location": "Yosemite, CA, USA",
    "activity": "Hiking"
  ]
]

Objective-C

NSDictionary *metadata = @{
  @"customMetadata": @{
    @"location": @"Yosemite, CA, USA",
    @"activity": @"Hiking"
  }
};

Sie können app-spezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank (z. B. die Firebase Realtime Database) zu verwenden, um diese Art von Daten zu speichern und zu synchronisieren.

Attribute von Dateimetadaten

Eine vollständige Liste der Metadatenattribute für eine Datei finden Sie unten:

Attribut Typ Bearbeitbar
bucket String Nein
generation String Nein
metageneration String Nein
fullPath String Nein
name String Nein
size INT64 Nein
timeCreated Datum Nein
updated Datum Nein
md5Hash String Ja
cacheControl String Ja
contentDisposition String Ja
contentEncoding String Ja
contentLanguage String Ja
contentType String Ja
customMetadata [String: String] Ja

Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch das Entfernen von Dateien. Hier erfahren Sie, wie Sie Dateien löschen aus Cloud Storage.