Enum Error 

pub enum Error {
    MailboxClosed,
    BrokerAlreadyStarted,
    MailboxFull,
    DuplicateActorName(ActorId),
    External(Arc<dyn Error + Send + Sync>),
    IoError(Arc<Error>),
    Internal(Arc<dyn Error + Send + Sync>),
    SettleTimeout(Duration, usize),
}

The single error type for all Maiko operations.

Every fallible Maiko API returns maiko::Result<T> (alias for Result<T, maiko::Error>). Errors from lower layers (Tokio channels, IO, task joins) are mapped into variants of this enum so callers only need to handle one error type.

Variants

MailboxClosed

The actor’s mailbox channel was closed (actor or broker shut down).

BrokerAlreadyStarted

Attempted to start the broker when it is already running.

MailboxFull

The actor’s mailbox is full and the overflow policy rejected the event.

DuplicateActorName(ActorId)

An actor with this name is already registered.

External(Arc<dyn Error + Send + Sync>)

An application-level error wrapped via Error::external().

IoError(Arc<Error>)

An I/O error from the underlying system.

Internal(Arc<dyn Error + Send + Sync>)

An internal Maiko error (e.g., task join failure).

SettleTimeout(Duration, usize)

Available on crate feature test-harness only.

A settle_on condition was not met within the timeout. Contains the timeout duration and the number of events recorded before expiry.

Implementations

impl Error

pub fn external(e: impl Error + Send + Sync + 'static) -> Self

Wrap an application-level error into Error::External.

Use this in Actor::handle_event or Actor::on_error to propagate domain errors through the Maiko error type.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<E> From<SendError<Arc<Envelope<E>>>> for Error

fn from(_e: SendError<Arc<Envelope<E>>>) -> Self

Converts to this type from the input type.

impl<E> From<TrySendError<Arc<Envelope<E>>>> for Error

fn from(e: TrySendError<Arc<Envelope<E>>>) -> Self

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error