Dokumen ini menjelaskan cara menggunakan enumerasi (enum) di Library Klien Cloud untuk Rust, termasuk menangani nilai enum yang diperkenalkan setelah rilis library.
Latar belakang
LayananGoogle Cloud menggunakan enumerasi untuk kolom yang menerima atau menyediakan sekumpulan nilai yang terpisah dan terbatas. Meskipun nilai yang diizinkan diketahui kapan saja, layanan dapat menambahkan nilai baru seiring waktu.
Library Klien Cloud untuk Rust dapat mengirim dan menerima nilai enum, termasuk nilai yang diperkenalkan setelah library dirilis.
Sebelum memulai
Contoh dalam dokumen ini berjalan secara lokal dan tidak memanggil layanan Google Cloud, sehingga Anda tidak memerlukan project atau akun Google Cloud . Contoh ini menggunakan library klien Secret Manager, dan prinsip yang sama berlaku untuk enumerasi di library klien lainnya.
Dependensi
Tambahkan library klien Secret Manager dan crate pendukung ke
file Cargo.toml Anda:
cargo add google-cloud-secretmanager-v1 serde_json anyhow
Menangani nilai yang diketahui
Saat menggunakan nilai yang diketahui, Anda dapat membuat varian enum secara langsung atau mengonversinya dari representasi bilangan bulat atau string:
Menangani nilai yang tidak diketahui
Saat enum menerima nilai string yang tidak dikenali, .value() akan menampilkan None,
sementara .name() dan serialisasi JSON akan terus berfungsi seperti yang diharapkan:
Untuk nilai bilangan bulat yang tidak diketahui, serialisasi JSON juga terus berfungsi seperti yang diharapkan, sementara .value() menampilkan bilangan bulat dan .name() menampilkan None:
Bersiap untuk upgrade
Enum di Library Klien Cloud untuk Rust dapat memperoleh varian baru dalam rilis mendatang.
Agar tidak merusak aplikasi Anda saat layanan menambahkan varian baru, library
menandai enum yang dihasilkan sebagai #[non_exhaustive].
Asumsikan enum State diimpor ke dalam cakupan:
Saat menulis ekspresi match pada enum yang tidak lengkap, sertakan
pola karakter pengganti (_) untuk mempertahankan kompatibilitas mundur
saat layanan menambahkan varian baru:
Jika Anda menginginkan peringatan linter saat varian baru muncul sehingga Anda dapat meninjau dan
memperbarui arm match, aktifkan
lint Clippy wildcard_enum_match_arm:
Anda juga dapat mempertimbangkan lint
non_exhaustive_omitted_patterns yang tidak stabil.