Using SwiftData to Store Large Files from an API call
Zusammenfassung
Kurz
Der vollständige Bericht erklärt anhand eines Swift-Beispiels, wie Fotos als Binärdaten mit `.externalStorage` in SwiftData abgelegt und anschließend offline aus der Datenbank angezeigt werden können. Der gezeigte Ablauf lädt API-Metadaten und Dateien, lässt bei fehlgeschlagenem Dateiabruf das Datenfeld leer und zeigt Bilder nur an, wenn sich die gespeicherten Bytes in ein `UIImage` umwandeln lassen. Leistungswerte, Tests und Grenzen bei Dateigrößen behandelt der Bericht nicht.
Mittel
Der vollständige Bericht zeigt anhand von Fotos, wie größere Dateien in SwiftData gespeichert und aus einer SwiftUI-Ansicht angezeigt werden können. Dazu ergänzt der Autor das Modell um ein optionales `Data`-Feld mit `.externalStorage`; die Binärdaten sollen dadurch außerhalb der eigentlichen Datenbankdatei, aber neben dem Modellspeicher liegen. Die API-Metadaten bleiben in einem DTO.
Der Beispiel-Webdienst lädt zunächst die DTOs und ruft für jedes Element zusätzlich die Datei von dessen URL ab. Bei Erfolg werden die Bytes dem Modell zugewiesen, bei einem Fehler bleibt das Feld leer. Der gezeigte Code prüft beim JSON-Abruf unter anderem HTTP-Status und Dekodierung und protokolliert Fehler.
Die Ansicht liest Bilder aus SwiftData statt sie bei jedem Anzeigen über `AsyncImage` aus dem Netz zu laden. Sie zeigt ein Bild, wenn dessen Daten zu `UIImage` konvertiert werden können; andernfalls bleibt der Platz leer. Ein initialer Abruf bei leerer Liste und eine Aktualisierung per Herunterziehen sind vorgesehen. Der Autor zufolge ermöglicht das den Offline-Zugriff nach dem ersten Abruf. Der Bericht liefert Beispielcode, aber keine Messungen, Tests oder Erläuterungen zu Größenlimits und Dateiverwaltung. Andere große Dateitypen werden als übertragbar genannt, jedoch nicht vorgeführt.
Ausführlich lesen
Der vollständige Bericht beschreibt, wie sich größere Dateien wie Fotos, Podcasts oder Videos mit SwiftData speichern und in einer SwiftUI-Ansicht anzeigen lassen. Das Beispiel baut auf einem früheren Tutorial zum Abruf von Daten aus einer API auf und verwendet Fotos als konkreten Anwendungsfall.
Im SwiftData-Modell `PhotoObject` wird eine optionale Eigenschaft vom Typ `Data` ergänzt. Das Attribut `.externalStorage` weist SwiftData laut Bericht an, diese Binärdaten außerhalb der eigentlichen Datenbankdatei, aber neben dem Modellspeicher abzulegen. So soll die Datenbank schlank und schnell bleiben. Die vorhandenen API-Metadaten werden weiterhin über ein DTO abgebildet; dessen Umwandlung in das SwiftData-Modell setzt zunächst keine Fotodaten.
Der Webdienst ruft zuerst die Fotodaten als DTOs von einer Beispiel-API ab. Für jedes Element erstellt der gezeigte Code eine Aufgabe, lädt die Datei über die angegebene URL und weist sie bei erfolgreichem Abruf der Eigenschaft `photo` zu. Schlägt der Dateiabruf fehl, bleibt diese Eigenschaft laut Beschreibung `nil`; anschließend wird das Modell in den Kontext eingefügt. Beim Abruf der DTO-Liste prüft der Beispielcode URL, HTTP-Antwort, Statuscode im 2xx-Bereich und JSON-Dekodierung. Fehler werden protokolliert. Der separate Dateiabruf gibt bei einem Fehler ebenfalls `nil` zurück.
Die Ansicht fragt die gespeicherten Modelle sortiert ab. Anders als im vorherigen Beispiel soll sie Bilder nicht mit `AsyncImage` direkt aus dem Netz laden, sondern aus den in SwiftData gespeicherten Daten darstellen. Wenn sich die Bytes in ein `UIImage` umwandeln lassen, erscheint das Bild in der Zeile; fehlen die Daten oder schlägt die Umwandlung fehl, bleibt der Bildbereich leer. Ist die Liste zu Beginn leer, startet die Ansicht den Datenabruf. Eine Aktualisierung lässt sich außerdem durch Herunterziehen auslösen. Der Autor folgert daraus, dass die App nach dem ersten Abruf auch ohne Netzwerkverbindung auf die gespeicherten Bilder zugreifen kann.
Der Bericht präsentiert vor allem Beispielcode und erklärt dessen vorgesehene Funktion. Er belegt keine Messungen zur Datenbankleistung und beschreibt keine Tests, Größenlimits oder Strategien für die Verwaltung und Aktualisierung gespeicherter Dateien. Das Beispiel behandelt Fotos; die Übertragbarkeit auf andere Dateitypen wird als möglich dargestellt, aber nicht separat demonstriert.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Fragen zur Einordnung angegeben (Sammel- und Teilfragen sind leer), daher gibt es keine Einordnung. Beide Zusammenfassungen von Luna wurden gemeinsam geprüft: Sie geben die Kernaussagen des Berichts korrekt wieder und enthalten keine erfundenen Angaben.
Im Bericht, aber nicht in der Zusammenfassung
- Der Bericht baut auf einem früheren Tutorial zu Remote-API-Daten auf, dessen Code hier erweitert wird
- In der kurzen Fassung fehlt der Hinweis, dass sich das Verfahren auch für andere große Dateien wie Video, Podcast oder Audiobücher eignet
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.