Struct xitca_web::error::ThreadJoinError

pub struct ThreadJoinError(pub Mutex<Box<dyn Any + Send>>);

error happens when joining a thread. typically caused by code panic inside thread. CatchUnwind middleware is able to produce this error type.

Examples:

fn handle_error(e: &ThreadJoinError) {
    // debug and display format thread join error. can only provide basic error message if the error
    // source is typical string.(for example generated by panic! macro or unwrap/expect methods)
    println!("{e:?}");
    println!("{e}");

    // for arbitrary thread join error manual type downcast is needed.(for example generated by std::panic::panic_any)
    // the mutex lock inside is to satisfy xitca-web's error type's thread safe guarantee: Send and Sync auto traits.
    //
    // rust's std library only offers Send bound for thread join error and the mutex is solely for the purpose of making
    // the error bound to Send + Sync.
    let any = e.0.lock().unwrap();

    // an arbitrary type we assume possibly being used as panic message.
    struct Foo;

    if let Some(_foo) = any.downcast_ref::<Foo>() {
        // if downcast is succeed it's possible to handle the typed panic message.
    }

    // otherwise there is basically no way to retrieve any meaningful information and it's best to just ignore the error.
    // xitca-web is able to generate minimal http response from it anyway.
}

Tuple Fields

0: Mutex<Box<dyn Any + Send>>

Trait Implementations

impl Debug for ThreadJoinError

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

Formats the value using the given formatter.

impl Display for ThreadJoinError

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

Formats the value using the given formatter.

impl Error for ThreadJoinError

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

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<C> From<ThreadJoinError> for Error<C>

fn from(e: ThreadJoinError) -> Self

Converts to this type from the input type.

impl<'r, C, B> Service<WebContext<'r, C, B>> for ThreadJoinError

type Response = Response<ResponseBody>

The Ok part of output future.

type Error = Infallible

The Err part of output future.

async fn call( &self, ctx: WebContext<'r, C, B> ) -> Result<Self::Response, Self::Error>