A biblioteca padrãoSlide 52 de 85
52--A biblioteca padrão
Anotações de campo
Gramática: field, annotations, annotation
fieldEspecificação §2.3
field = IDENT ":" type [ annotations ] ;annotationsEspecificação §2.3
annotations = "--" annotation { annotation } ;Como o compilador lê; o §2.3 da especificação está desatualizado aqui.annotationEspecificação §2.3
annotation = ( "JSON" | "URL" | "Flag" ) "as" ( key | STRING ) ";" | "Default" "as" literal ";" ;Como o compilador lê; o §2.3 da especificação está desatualizado aqui.Um campo pode ser anotado depois de um --, cada cláusula terminando no seu ;, em qualquer ordem. Toda anotação é sobre os codecs — como o campo se chama no fio, e o que ler onde o fio não tem nada — e nenhuma muda o campo do lado do Hive:
JSON as <chave>;é a chave de onde o campo é lido e com que é escrito, nas duas direções, então uma ida e volta concorda consigo mesma. Uma chave é o nome de outra pessoa, que não segue nenhuma das formas do Hive:user_nameeuser-namesão chaves, e qualquer outra coisa vai entre aspas,"user name". É também como um campo cuja chave é uma palavra-chave ganha um nome próprio:kind: Str -- JSON as type;.URL as <chave>;eFlag as <nome>;dizem o mesmo para uma query string e para uma flag de linha de comando, uma flag sem os traços —Flag as dry-run;é--dry-run, eFlag as dry-run n;acrescenta-n, o mais curto dos dois nomes sendo o curto.Default as <literal>;é o que ler onde a chave está ausente ou énull: um literalInt,Float,Str,BoolouAtomque o campo possa guardar, números negativos incluídos. Ele cobre só o que nunca foi dito: um valor do tipo errado continua sendo um erro.
Dois campos atendendo a uma mesma chave em qualquer formato são um erro de compilação, já que o decodificador leria o membro duas vezes. Um campo compartilhado é anotado uma vez para toda variante a que se junta.
As anotações guiam as duas metades
type User {
name: Str -- JSON as username;
age: Int
firstName: Str -- Default as "";
kind: Str -- JSON as type; Default as "member";
}
proc main(): void {
// A chave é username nas duas direções, então a ida e volta concorda.
echo encode(User("ada", 36, "Ada", "admin"), hive.json.codec())
// firstName e type estão ausentes aqui, e cada Default os substitui.
if User.decode("\{\"username\":\"ada\",\"age\":36}", hive.json.codec()) is Result.Ok(u) {
echo "[{u.firstName}] {u.kind}"
}
}Dá para editar este programa e rodá-lo aqui.Tab indenta, Esc sai do programa e Ctrl+Enter o roda.