Safe Union

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) ซึ่งเป็นเมธอดในการหาตัวเลือก Disriminator ปัจจุบัน (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;
};