Rust: Handle (A tons of ) Optional Fields in Struct: Best Practice?
Zusammenfassung
Kurz
Der Autor schlägt als persönliche Lösung vor, optionale Rust-Felder in eine separate, mit `flatten` eingebundene Struktur auszulagern und sie über eine `HashMap<String, Value>` an eine Konstruktorfunktion zu übergeben. Unbekannte Schlüssel lösen laut Beitrag keinen Fehler aus; deshalb sollen zulässige Schlüssel dokumentiert werden, und bei `camelCase`-Serialisierung muss auch die Map diese Schreibweise nutzen.
Mittel
Der Autor stellt eine persönliche Methode vor, um bei Rust-Request-Strukturen nicht ständig alle optionalen Felder einzeln mit `None` oder `Some` angeben zu müssen. Er lagert die optionalen Felder in eine eigene Struktur aus und versieht das entsprechende Feld in der Hauptstruktur mit Serdes `flatten`, damit die JSON-Felder weiterhin direkt auf oberster Ebene erscheinen.
Eine Konstruktorfunktion nimmt die Pflichtwerte sowie eine optionale `HashMap<String, Value>` entgegen. Aufrufer tragen dort nur die optionalen Werte ein, die sie brauchen. Die Funktion wandelt die Map über JSON-Serialisierung und -Deserialisierung mit Serde in die Struktur der optionalen Felder um. Im Beispiel werden gesetzte Optionen ausgegeben; ohne Map enthält das JSON nur die Pflichtfelder.
Der Beitrag betont eine Einschränkung: Unbekannte Map-Schlüssel führen laut Autor nicht zu einem Fehler. Er empfiehlt daher, gültige Schlüssel in der Funktionsdokumentation aufzulisten. Wegen `rename_all = "camelCase"` müssen die Schlüssel in der Map camelCase geschrieben sein. Die Methode ist ausdrücklich die persönliche Meinung des Autors; Leserreaktionen nennen unter anderem das `Default`-Trait als Alternative, die im Beitrag nicht geprüft wird.
Ausführlich lesen
Der Beitrag beschreibt eine persönliche, ausdrücklich nicht als allgemeingültige Best Practice gemeinte Methode, viele optionale Felder in Rust-Request-Strukturen einfacher zu befüllen. Ausgangspunkt ist, dass beim direkten Erzeugen einer Struktur jedes Feld vom Typ `Option` mit `None` oder `Some` angegeben werden muss. Eine `new`-Funktion kann zwar zunächst alle optionalen Felder auf `None` setzen, doch bei später gewünschten Werten muss man die Struktur laut Autor weiterhin umständlich ergänzen.
Sein Vorschlag: Die Pflichtfelder bleiben in der Hauptstruktur, während alle optionalen Felder in eine eigene Struktur ausgelagert werden. Mit Serdes `flatten` sollen deren Felder beim Serialisieren und Deserialisieren direkt auf der Ebene der Hauptstruktur erscheinen. Die Felder werden weiterhin als `Option` behandelt und bei `None` durch `skip_serializing_if` in der JSON-Ausgabe ausgelassen.
Die Konstruktorfunktion nimmt zusätzlich eine optionale `HashMap<String, Value>` entgegen. Aufrufer tragen nur die optionalen Werte ein, die sie tatsächlich setzen möchten. Im Beispiel wird ein Wert zunächst mit `serde_json::to_value` in die Map gelegt. Die Funktion wandelt dann die Map in einen JSON-String und deserialisiert diesen mit Serde in die separate Struktur für optionale Parameter. So übernimmt Serde laut Beitrag die Zuordnung und Typumwandlung. Die gezeigte Ausgabe enthält bei gesetztem Wert die Pflichtfelder und das betreffende optionale Feld; ohne Parameter erscheinen nur die Pflichtfelder.
Der Autor weist auf eine wichtige Einschränkung hin: Bei diesem Funktionsaufruf sind die zulässigen Schlüssel nicht durch die Funktionssignatur ersichtlich. Unbekannte Map-Schlüssel lösen nach seiner Darstellung keinen Fehler aus. Deshalb empfiehlt er, die akzeptierten Schlüssel samt Erläuterungen in der Dokumentation der Funktion aufzuführen. Da die Strukturen `camelCase` verwenden, müssen die Map-Schlüssel ebenfalls in dieser Schreibweise angegeben werden.
Der Beitrag belegt die Lösung mit einem kleinen Beispiel, liefert aber keinen Vergleich mit Alternativen oder umfassende Prüfung. In den angehängten Leserreaktionen wird unter anderem vorgeschlagen, stattdessen das `Default`-Trait zu verwenden; eine Bewertung dieser Alternative enthält der Autor nicht. Die Empfehlung bleibt somit seine persönliche Einschätzung.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna hat keine Sammel- oder Teilfragen zur Einordnung angegeben. Deshalb wurde keine Einordnung vorgenommen.
Im Bericht, aber nicht in der Zusammenfassung
- Die Begründung, dass Rust keine Standardwerte für Funktionsparameter kennt und deshalb viele `None`/`Some`-Angaben nötig sind
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.