Neste documento, explicamos como usar enumerações (enums) nas bibliotecas de cliente do Cloud para Rust, incluindo o processamento de valores de enum introduzidos após o lançamento da biblioteca.
Contexto
Os serviços doGoogle Cloud usam enumerações para campos que aceitam ou fornecem um conjunto discreto e limitado de valores. Embora os valores permitidos sejam conhecidos a qualquer momento, os serviços podem adicionar novos valores ao longo do tempo.
As bibliotecas de cliente do Cloud para Rust podem enviar e receber valores de tipo enumerado, incluindo valores introduzidos após o lançamento da biblioteca.
Antes de começar
Os exemplos neste documento são executados localmente e não chamam serviços do Google Cloud. Portanto, você não precisa de um projeto ou uma conta do Google Cloud . Os exemplos usam a biblioteca de cliente do Secret Manager, e os mesmos princípios se aplicam a enumerações em qualquer outra biblioteca de cliente.
Dependências
Adicione a biblioteca de cliente do Secret Manager e os crates de suporte ao
arquivo Cargo.toml:
cargo add google-cloud-secretmanager-v1 serde_json anyhow
Processar valores conhecidos
Ao trabalhar com valores conhecidos, é possível criar variantes de tipo enumerado diretamente ou convertê-las de representações de números inteiros ou strings:
Processar valores desconhecidos
Quando um tipo enumerado recebe um valor de string não reconhecido, .value() retorna None,
enquanto .name() e a serialização JSON continuam funcionando como esperado:
Para valores inteiros desconhecidos, a serialização JSON também continua funcionando como
esperado, enquanto .value() retorna o número inteiro e .name() retorna None:
Preparar para upgrades
Os tipos enumerados nas bibliotecas de cliente do Cloud para Rust podem ganhar novas variantes em versões futuras.
Para evitar que o aplicativo seja interrompido quando um serviço adicionar novas variantes, a biblioteca
marca os tipos enumerados gerados como #[non_exhaustive].
Suponha que o tipo enumerado State seja importado para o escopo:
Ao escrever uma expressão match sobre um tipo enumerado alguns exemplos, inclua o
padrão de caractere curinga (_) para manter a compatibilidade com versões anteriores
quando um serviço adicionar novas variantes:
Se você quiser um aviso do linter quando novas variantes aparecerem para analisar e
atualizar os braços match, ative o
lint Clippy wildcard_enum_match_arm:
Você também pode considerar o lint instável
non_exhaustive_omitted_patterns.