Bezpieczne zjednoczenie

safe_union w HIDL reprezentuje jednoznacznie oznaczony typ zjednoczenia. Jest to podobne do union, z tym że safe_union śledzi typ bazowy i jest zgodny z językiem Java. Typ safe_union jest dostępny w Androidzie 10 i nowszych wersjach na nowych i uaktualnionych urządzeniach.

Składnia

W HIDL element safe_union jest wyrażany dokładnie tak samo jak element union lub struct.

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

Wykorzystanie

W czasie wykonywania safe_union ma zawsze tylko jeden typ. Domyślnie jest to pierwszy typ w zbiorze. Na przykład w przykładzie powyżej zmienna MySafeUnion ma domyślnie wartość TypeA.

hidl-gen generuje niestandardową klasę lub strukturę dla funkcji safe_union w C++ i Java. Ta klasa zawiera wyróżnik dla każdego elementu (w hidl_discriminator), metodę do pobierania bieżącego wyróżnika (getDiscriminator) oraz metody ustawiania i pobierania dla każdego elementu. Każda metoda setter i getter ma taką samą nazwę jak jej element. Na przykład metoda dostępu do właściwości TypeA a nosi nazwę „a” i zwraca coś z TypeA. Odpowiadający mu setter ma też nawę „a” i parametry TypeA. Ustawienie wartości w a safe_union aktualizuje wartość dyskryminatora zwracanego przez getDiscriminator. Uzyskanie dostępu do wartości z kryterium, które nie jest bieżącym kryterium, powoduje przerwanie programu. Jeśli na przykład wywołanie getDiscriminator w instancji MySafeUnion zwraca wartość hidl_discriminator::b, próba pobrania wartości a powoduje przerwanie programu.

Monostate

Element safe_union ma zawsze wartość, ale jeśli nie chcesz podawać wartości, użyj zmiennej android.hidl.safe_union@1.0::Monostate jako elementu zastępczego. Na przykład ta operacja union może być noinit (pusta) lub foo:

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

safe_union OptionalFoo {
     Monostate noinit;
     Foo foo;
};