Verwenden Sie Dateimetadaten mit Cloud Storage auf Apple-Plattformen

Nachdem Sie eine Datei in die Cloud Storage-Referenz hochgeladen haben, können Sie auch die Metadaten der Datei abrufen und aktualisieren, um beispielsweise den Inhaltstyp zu aktualisieren. Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten speichern.

Dateimetadaten abrufen

Dateimetadaten enthalten allgemeine Eigenschaften wie name , size und contentType (häufig als MIME-Typ bezeichnet) sowie einige weniger häufige Eigenschaften wie contentDisposition und timeCreated . Diese Metadaten können mithilfe der Methode metadataWithCompletion: aus einer Cloud Storage-Referenz abgerufen werden.

Schnell

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

Ziel 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 Dateimetadaten jederzeit nach Abschluss des Datei-Uploads aktualisieren, indem Sie die Methode updateMetadata:withCompletion: verwenden. Weitere Informationen darüber, welche Eigenschaften aktualisiert werden können, finden Sie in der vollständigen Liste . Es werden nur die in den Metadaten angegebenen Eigenschaften aktualisiert, alle anderen bleiben unverändert.

Schnell

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

Ziel 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 beschreibbare Metadateneigenschaften löschen, indem Sie sie auf nil setzen:

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

Schnell

let newMetadata = StorageMetadata()
newMetadata.contentType = nil

do {
  // Delete the metadata property
  let updatedMetadata = try await forestRef.updateMetadata(newMetadata)
} catch {
  // ...
}

Behandeln Sie Fehler

Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten können, darunter, dass die Datei nicht vorhanden ist oder der Benutzer keine Berechtigung zum Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie im Abschnitt „Fehler behandeln“ der Dokumentation.

Benutzerdefinierte Metadaten

Sie können benutzerdefinierte Metadaten als NSDictionary angeben, das NSString Eigenschaften enthält.

Schnell

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

Ziel 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.

Dateimetadateneigenschaften

Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:

Eigentum	Typ	Schreibbar
`bucket`	Zeichenfolge	NEIN
`generation`	Zeichenfolge	NEIN
`metageneration`	Zeichenfolge	NEIN
`fullPath`	Zeichenfolge	NEIN
`name`	Zeichenfolge	NEIN
`size`	Int64	NEIN
`timeCreated`	Datum	NEIN
`updated`	Datum	NEIN
`md5Hash`	Zeichenfolge	Ja
`cacheControl`	Zeichenfolge	Ja
`contentDisposition`	Zeichenfolge	Ja
`contentEncoding`	Zeichenfolge	Ja
`contentLanguage`	Zeichenfolge	Ja
`contentType`	Zeichenfolge	Ja
`customMetadata`	[Zeichenfolge: Zeichenfolge]	Ja

Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch die Möglichkeit, sie zu entfernen. Erfahren Sie, wie Sie Dateien aus dem Cloud-Speicher löschen .