Enum Undeliverable 

pub enum Undeliverable<M: Message> {
    Returned(M),
    Report(DeliveryFailureReport),
}

An undeliverable M-typed message.

Variants

Returned(M)

The message was returned intact.

Report(DeliveryFailureReport)

Delivery failed, but the original payload is unavailable.

Implementations

impl<M: Message> Undeliverable<M>

pub fn is_returned(&self) -> bool

Returns true if this is a Undeliverable::Returned, otherwise false

pub fn as_returned_mut(&mut self) -> Option<&mut M>

Optionally returns mutable references to the inner fields if this is a Undeliverable::Returned, otherwise None

pub fn as_returned(&self) -> Option<&M>

Optionally returns references to the inner fields if this is a Undeliverable::Returned, otherwise None

pub fn into_returned(self) -> Result<M, Self>

Returns the inner fields if this is a Undeliverable::Returned, otherwise returns back the enum in the Err case of the result

pub fn is_report(&self) -> bool

Returns true if this is a Undeliverable::Report, otherwise false

pub fn as_report_mut(&mut self) -> Option<&mut DeliveryFailureReport>

Optionally returns mutable references to the inner fields if this is a Undeliverable::Report, otherwise None

pub fn as_report(&self) -> Option<&DeliveryFailureReport>

Optionally returns references to the inner fields if this is a Undeliverable::Report, otherwise None

pub fn into_report(self) -> Result<DeliveryFailureReport, Self>

Returns the inner fields if this is a Undeliverable::Report, otherwise returns back the enum in the Err case of the result

impl<M: Message> Undeliverable<M>

pub fn message(message: M) -> Self

Construct an undeliverable message that preserves the original payload.

pub fn as_message(&self) -> Option<&M>

Borrow the returned payload, if the payload was returned.

pub fn as_message_mut(&mut self) -> Option<&mut M>

Mutably borrow the returned payload, if the payload was returned.

pub fn into_message(self) -> Result<M, Self>

Consume this undeliverable notification and return its payload, if the payload was returned.

pub fn report(report: DeliveryFailureReport) -> Self

Construct an undeliverable message that carries only delivery-failure metadata.

impl Undeliverable<MessageEnvelope>

pub fn root_delivery_failure(&self) -> Option<&DeliveryFailure>

Get the root structured delivery failure for this undeliverable notification.

pub fn into_error(self) -> UndeliverableMessageError

Convert this undeliverable notification into the corresponding error.

Trait Implementations

impl<M: Clone + Message> Clone for Undeliverable<M>

fn clone(&self) -> Undeliverable<M>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M: Debug + Message> Debug for Undeliverable<M>

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

Formats the value using the given formatter.

impl<'de, M> Deserialize<'de> for Undeliverable<M>

where M: Deserialize<'de> + Message,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<M: Message + Named> Named for Undeliverable<M>

fn typename() -> &'static str

The globally unique type name for the type. This should typically be the fully qualified Rust name of the type.

fn typehash() -> u64

A globally unique hash for this type. TODO: actually enforce perfect hashing

fn arm(&self) -> Option<&'static str>

If the named type is an enum, this returns the name of the arm of the value self.

fn typeid() -> TypeId

The TypeId for this type. TypeIds are unique only within a binary, and should not be used for global identification.

fn port() -> u64

A globally unique numeric identifier for this type.

unsafe fn arm_unchecked(self_: *const ()) -> Option<&'static str>

An unsafe version of ‘arm’, accepting a pointer to the value, for use in type-erased settings.

impl<M> Serialize for Undeliverable<M>

where M: Serialize + Message,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.