safe_union
no HIDL representa um tipo de união marcado explicitamente.
Isso é semelhante a um union
, exceto pelo fato de que safe_union
monitora o tipo subjacente e é compatível com Java. O
tipo safe_union
está disponível no Android 10
e versões mais recentes para dispositivos novos e atualizados.
Sintaxe
Um safe_union
é expresso em HIDL exatamente como um
union
ou struct
.
safe_union MySafeUnion { TypeA a; TypeB b; ... };
Uso
No momento da execução, um safe_union
é apenas um tipo. Por padrão, é o primeiro tipo na união. Por exemplo, acima, MySafeUnion
é por padrão TypeA
.
hidl-gen
gera uma classe ou estrutura personalizada para um
safe_union
em C++ e Java. Essa classe inclui um
discriminador para cada membro (em hidl_discriminator
), um método para
extrair o discriminador atual (getDiscriminator
) e setters e
getters para cada membro. Cada setter e getter é nomeado exatamente como o membro.
Por exemplo, o getter de TypeA a
é chamado de "a" e
retorna algo de TypeA
. O setter correspondente também
é chamado de "a" e usa um parâmetro de TypeA
. A definição do valor em
um safe_union
atualiza o valor do discriminador conforme
retornado por getDiscriminator
. O acesso a um valor por um discriminador que não é o atual cancela o programa. Por
exemplo, se chamar getDiscriminator
em uma instância de
MySafeUnion
retornar hidl_discriminator::b
, a
tentativa de recuperar a
aborta o programa.
Monoestado
Um safe_union
sempre tem um valor, mas, se não
quiser ter um valor, use android.hidl.safe_union@1.0::Monostate
como um
marcador de posição. Por exemplo, a seguinte união pode ser
noinit
(vazia) ou foo
:
import android.hidl.safe_union@1.0::Monostate; safe_union OptionalFoo { Monostate noinit; Foo foo; };