Rust: Custom Serde Fields Deserialization
Zusammenfassung
Kurz
Der vollständige Bericht demonstriert, wie Serdes `deserialize_with` einen einzelnen String oder ein String-Array in dasselbe `Vec<String>`-Feld überführt. Das ebenfalls erwähnte Problem leerer Strings bei Zahlenfeldern wird nicht behandelt.
Mittel
Der vollständige Bericht zeigt, wie Serde ein Feld mit einer eigenen `deserialize_with`-Funktion einlesen kann, wenn eine API denselben Wert uneinheitlich als Array oder als einzelnen String liefert. Im Beispiel ist `favorite_food` als `Vec<String>` definiert. Die normale Deserialisierung funktioniert laut Artikel mit einem Array, scheitert aber bei einem einzelnen String.
Die Funktion `to_vec_string` liest den JSON-Wert über eine intern definierte, nicht markierte Enum ein. Bei einem String macht sie daraus einen Vektor mit einem Element; einen vorhandenen Vektor gibt sie weiter. Mit `#[serde(deserialize_with = "to_vec_string")]` am Feld sollen damit beide Antwortformen in dasselbe Struct passen. Der Autor bevorzugt das gegenüber einem Feldtyp, der beide Eingabeformen direkt abbildet.
Der Beitrag erwähnt auch leere Strings anstelle fehlender Zahlenwerte als API-Problem, führt dafür aber keine Lösung vor. Das gezeigte Verfahren behandelt konkret nur Strings und Vektoren aus Strings.
Ausführlich lesen
Der vollständige Bericht erklärt, wie sich in Rust mit Serde ein einzelnes struct-Feld über eine eigene Deserialisierungsfunktion flexibler einlesen lässt. Anlass sind uneinheitliche API-Antworten: Der Artikel nennt als Beispiele ein Feld, das je nach Anzahl der Werte entweder als Array oder als einzelner String geliefert wird, sowie ein Zahlenfeld, das bei fehlenden Daten als leerer String erscheint.
Das konkrete Beispiel ist `favorite_food` in einem `UserInfo`-Struct. Das Feld hat den Typ `Vec<String>`. Laut Artikel funktioniert Serdes normale Deserialisierung, wenn die JSON-Antwort ein Array enthält; bei einem einzelnen String schlägt sie fehl. Die vorgeschlagene Lösung versieht das Feld mit `#[serde(deserialize_with = "to_vec_string")]`. Die dafür definierte Funktion liest den Wert mithilfe einer intern abgeleiteten, nicht markierten Enum ein, deren Varianten einen String oder einen Vektor von Strings abdecken. Ein String wird anschließend in einen Vektor mit genau einem Element umgewandelt; ein bereits vorhandener Vektor wird unverändert übernommen.
Der Artikel zeigt Beispiele, in denen dadurch beide JSON-Formen zu einem `UserInfo` mit `Vec<String>` werden. Er hebt außerdem hervor, dass die angegebene Funktion die von Serde verlangte generische Signatur mit einem Deserializer und einem Ergebnis mit dessen Fehlertyp haben muss. Für ein Feld mit `deserialize_with` sei es nicht erforderlich, dass dessen Typ selbst `Deserialize` implementiert. Der Autor hält diese Lösung für übersichtlicher, als den gemischten Eingabetyp direkt als Feldtyp `StringOrVec` im Struct zu verwenden.
Die Reichweite des Beispiels ist begrenzt: Obwohl der Bericht auch den Fall eines leeren Strings für ein Zahlenfeld als mögliches API-Problem erwähnt, entwickelt er dafür keine Lösung. Er behandelt konkret nur die Vereinheitlichung eines einzelnen Strings oder eines String-Arrays zu `Vec<String>`. Eine allgemeinere Behandlung anderer JSON-Typen oder fehlender und null gesetzter Felder wird nicht gezeigt.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Fragen zur Einordnung angegeben, daher wurde nur die Zusammenfassung geprüft. Die Kernaussagen beider Fassungen stimmen mit dem Bericht überein, bis auf die falsche Angabe zur Enum-Markierung.
Im Bericht, aber nicht in der Zusammenfassung
- Die Anforderungen an die Funktionssignatur von deserialize_with und dass Felder dafür nicht Deserialize implementieren müssen
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die Enum in to_vec_string wird als "nicht markiert" beschrieben; der Bericht zeigt aber #[serde(untagged)]
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.