In diesem Dokument wird erläutert, wie Sie Enumerationen (Enums) in den Cloud-Clientbibliotheken für Rust verwenden, einschließlich der Verarbeitung von Enum-Werten, die nach der Veröffentlichung der Bibliothek eingeführt wurden.
Hintergrund
Google Cloud -Dienste verwenden Aufzählungen für Felder, die eine diskrete, begrenzte Anzahl von Werten akzeptieren oder bereitstellen. Obwohl die zulässigen Werte jederzeit bekannt sind, können Dienste im Laufe der Zeit neue Werte hinzufügen.
Die Cloud-Clientbibliotheken für Rust können Enum-Werte senden und empfangen, einschließlich Werte, die nach der Veröffentlichung der Bibliothek eingeführt wurden.
Hinweis
Die Beispiele in diesem Dokument werden lokal ausgeführt und rufen keine Google Cloud-Dienste auf. Sie benötigen also kein Google Cloud -Projekt oder -Konto. In den Beispielen wird die Secret Manager-Clientbibliothek verwendet. Dieselben Prinzipien gelten für Aufzählungen in jeder anderen Clientbibliothek.
Abhängigkeiten
Fügen Sie die Secret Manager-Clientbibliothek und die unterstützenden Crates der Datei Cargo.toml hinzu:
cargo add google-cloud-secretmanager-v1 serde_json anyhow
Bekannte Werte verarbeiten
Wenn Sie mit bekannten Werten arbeiten, können Sie Enum-Varianten direkt erstellen oder sie aus Ganzzahl- oder Stringdarstellungen konvertieren:
Umgang mit unbekannten Werten
Wenn ein Enum einen nicht erkannten Stringwert empfängt, gibt .value() den Wert None zurück, während .name() und die JSON-Serialisierung weiterhin wie erwartet funktionieren:
Bei unbekannten Ganzzahlwerten funktioniert die JSON-Serialisierung weiterhin wie erwartet, während .value() die Ganzzahl und .name() den Wert None zurückgibt:
Auf Upgrades vorbereiten
Enums in den Cloud-Clientbibliotheken für Rust können in zukünftigen Releases neue Varianten erhalten.
Damit Ihre Anwendung nicht beeinträchtigt wird, wenn ein Dienst neue Varianten hinzufügt, werden generierte Enums in der Bibliothek als #[non_exhaustive] markiert.
Angenommen, das Enum State wird in den Bereich importiert:
Wenn Sie einen match-Ausdruck für eine unvollständige Enum schreiben, fügen Sie das Platzhaltermuster (_) ein, um die Abwärtskompatibilität zu gewährleisten, wenn ein Dienst neue Varianten hinzufügt:
Wenn Sie eine Linter-Warnung erhalten möchten, wenn neue Varianten angezeigt werden, damit Sie Ihre match-Zweige prüfen und aktualisieren können, aktivieren Sie den Clippy-Lint wildcard_enum_match_arm:
Sie können auch den instabilen Lint non_exhaustive_omitted_patterns in Betracht ziehen.