สหภาพแบบปลอดภัย

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 จะมีเพียง 1 ประเภทเท่านั้นที่รันไทม์ โดยค่าเริ่มต้น จะเป็นประเภทแรกในยูเนียน ตัวอย่างเช่น ด้านบน MySafeUnion คือ TypeA โดยค่าเริ่มต้น

hidl-gen สร้างคลาสหรือโครงสร้างที่กำหนดเองสำหรับ safe_unionทั้งใน C++ และ Java คลาสนี้มีตัวแบ่งสำหรับสมาชิกแต่ละคน (ใน hidl_discriminator) วิธีการรับตัวแบ่งปัจจุบัน (getDiscriminator) รวมถึงตัวตั้งค่าและตัวรับสำหรับสมาชิกแต่ละคน โดยชื่อของ setter และ getter แต่ละรายการจะเหมือนกับชื่อของสมาชิก เช่น Getter สําหรับ 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;
};