Struct ParcelableHolder

pub struct ParcelableHolder { /* private fields */ }

A container that can hold any arbitrary Parcelable.

This type is currently used for AIDL parcelable fields.

ParcelableHolder is currently not thread-safe (neither Send nor Sync), mainly because it internally contains a Parcel which in turn is not thread-safe.

Implementations

impl ParcelableHolder

pub fn new(stability: Stability) -> Self

Construct a new ParcelableHolder with the given stability.

pub fn reset(&mut self)

Reset the contents of this ParcelableHolder.

Note that this method does not reset the stability, only the contents.

pub fn set_parcelable<T>(&mut self, p: Arc<T>) -> Result<(), StatusCode>

where T: Any + Parcelable + ParcelableMetadata + Debug + Send + Sync,

Set the parcelable contained in this ParcelableHolder.

pub fn get_parcelable<T>(&self) -> Result<Option<Arc<T>>, StatusCode>

where T: Any + Parcelable + ParcelableMetadata + Default + Debug + Send + Sync,

Retrieve the parcelable stored in this ParcelableHolder.

This method attempts to retrieve the parcelable inside the current object as a parcelable of type T. The object is validated against T by checking that its parcelable descriptor matches the one returned by T::get_descriptor().

Returns one of the following:

• Err(_) in case of error
• Ok(None) if the holder is empty or the descriptor does not match
• Ok(Some(_)) if the object holds a parcelable of type T with the correct descriptor

pub fn get_stability(&self) -> Stability

Return the stability value of this object.

Trait Implementations

impl Clone for ParcelableHolder

fn clone(&self) -> ParcelableHolder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ParcelableHolder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deserialize for ParcelableHolder

type UninitType = ParcelableHolder

Type for the uninitialized value of this type. Will be either Self if the type implements Default, Option<Self> otherwise.

fn uninit() -> Self::UninitType

Return an uninitialized or default-initialized value for this type.

fn from_init(value: Self) -> Self::UninitType

Convert an initialized value of type Self into Self::UninitType.

fn deserialize(parcel: &BorrowedParcel<'_>) -> Result<Self, StatusCode>

Deserialize an instance from the given crate::parcel::Parcel.

const ASSERT_UNINIT_SIZE_AND_ALIGNMENT: bool = _

Assert at compile-time that Self and Self::UninitType have the same size and alignment. This will either fail to compile or evaluate to true. The only two macros that work here are panic! and assert!, so we cannot use assert_eq!.

fn deserialize_from( &mut self, parcel: &BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Deserialize an instance from the given crate::parcel::Parcel onto the current object. This operation will overwrite the old value partially or completely, depending on how much data is available.

impl Parcelable for ParcelableHolder

fn write_to_parcel( &self, parcel: &mut BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Internal serialization function for parcelables.

fn read_from_parcel( &mut self, parcel: &BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Internal deserialization function for parcelables.

impl Serialize for ParcelableHolder

fn serialize(&self, parcel: &mut BorrowedParcel<'_>) -> Result<(), StatusCode>

Serialize this instance into the given crate::parcel::Parcel.