Struct ParcelableHolder

pub struct ParcelableHolder<STABILITY: StabilityType> { /* 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<STABILITY: StabilityType> ParcelableHolder<STABILITY>

pub fn new() -> 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<STABILITY: StabilityType> Clone for ParcelableHolder<STABILITY>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<STABILITY: Debug + StabilityType> Debug for ParcelableHolder<STABILITY>

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

Formats the value using the given formatter.

impl<STABILITY: StabilityType> Default for ParcelableHolder<STABILITY>

fn default() -> Self

Returns the “default value” for a type.

impl<STABILITY: StabilityType> Deserialize for ParcelableHolder<STABILITY>

type UninitType = ParcelableHolder<STABILITY>

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<STABILITY: StabilityType> Parcelable for ParcelableHolder<STABILITY>

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<STABILITY: StabilityType> Serialize for ParcelableHolder<STABILITY>

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

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