Безопасный союз

safe_union в HIDL представляет собой явно обозначенный тип объединения. Он похож на union , за исключением того, что safe_union отслеживает базовый тип и совместим с Java. Тип safe_union доступен в Android 10 и более поздних версиях для новых и обновлённых устройств.

Синтаксис

safe_union выражается в HIDL точно так же, как union или struct .

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

Использование

Во время выполнения safe_union всегда имеет только один тип. По умолчанию это первый тип в объединении. Например, выше MySafeUnion по умолчанию имеет TypeA .

hidl-gen генерирует пользовательский класс или структуру для safe_union как в C++, так и в Java. Этот класс включает дискриминатор для каждого члена (в hidl_discriminator ), метод для получения текущего дискриминатора ( getDiscriminator ), а также сеттеры и геттеры для каждого члена. Каждый сеттер и геттер названы точно так же, как и его член. Например, геттер для TypeA a называется "a" и возвращает что-то из TypeA . Соответствующий сеттер также называется "a" и принимает параметр TypeA . Установка значения в safe_union обновляет значение дискриминатора, возвращаемое getDiscriminator . Доступ к значению из дискриминатора, который не является текущим дискриминатором, приводит к прерыванию программы. Например, если вызов getDiscriminator для экземпляра MySafeUnion возвращает hidl_discriminator::b , то попытка извлечь a приводит к прерыванию программы.

Моногосударство

У safe_union всегда есть значение, но если требуется, чтобы оно не имело значения, используйте android.hidl.safe_union@1.0::Monostate в качестве плейсхолдера. Например, следующее объединение может быть либо noinit (пустым), либо foo :

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

safe_union OptionalFoo {
     Monostate noinit;
     Foo foo;
};