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

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;
};