Unione sicura

safe_union in HIDL rappresenta un tipo di unione con tag esplicitamente. È simile a union, ad eccezione di safe_union che conserva del tipo sottostante ed è compatibile con Java. Il tipo safe_union è disponibile in Android 10 e versioni successive per i dispositivi nuovi e di cui è stato eseguito l'upgrade.

Sintassi

Un safe_union viene espresso in HIDL esattamente come un union o un struct.

safe_union MySafeUnion {
     TypeA a;
     TypeB b;
     ...
};

Utilizzo

In fase di esecuzione, un safe_union è sempre di un solo tipo. Per impostazione predefinita, il primo tipo nell'unione. Ad esempio, sopra, Il valore predefinito di MySafeUnion è TypeA.

hidl-gen genera una classe o uno struct personalizzato per un safe_union sia in C++ che in Java. Questo corso include un discriminatore per ogni membro (in hidl_discriminator), un metodo per ottenere l'attuale discriminatore (getDiscriminator), getter per ogni membro. Ogni setter e getter è denominato esattamente come il relativo membro. Ad esempio, il getter per TypeA a si chiama "a" e restituisce un valore TypeA. Il relativo settore può anche essere chiamato "a" e accetta un parametro TypeA. Impostando il valore in safe_union aggiorna il valore del discriminatore restituito da getDiscriminator. Accesso a un valore da un il discriminatore corrente che non è quello attuale interrompe il programma. Per se chiami getDiscriminator su un'istanza di MySafeUnion restituisce hidl_discriminator::b, poi il tentativo di recuperare a interrompe il programma.

Monostato

Un safe_union ha sempre un valore, ma se non vuoi che ne abbia uno, utilizza android.hidl.safe_union@1.0::Monostate come segnaposto. Ad esempio, la seguente unione può essere noinit (vuoto) o foo:

import android.hidl.safe_union@1.0::Monostate;

safe_union OptionalFoo {
     Monostate noinit;
     Foo foo;
};