Enum thrift::Error

source ·
pub enum Error {
    Transport(TransportError),
    Protocol(ProtocolError),
    Application(ApplicationError),
    User(Box<dyn Error + Sync + Send>),
}
Expand description

Error type returned by all runtime library functions.

thrift::Error is used throughout this crate as well as in auto-generated Rust code. It consists of four variants defined by convention across Thrift implementations:

  1. Transport: errors encountered while operating on I/O channels
  2. Protocol: errors encountered during runtime-library processing
  3. Application: errors encountered within auto-generated code
  4. User: IDL-defined exception structs

The Application variant also functions as a catch-all: all handler errors are automatically turned into application errors.

All error variants except Error::User take an eponymous struct with two required fields:

  1. kind: variant-specific enum identifying the error sub-type
  2. message: human-readable error info string

kind is defined by convention while message is freeform. If none of the enumerated kinds are suitable use Unknown.

To simplify error creation convenience constructors are defined for all variants, and conversions from their structs (thrift::TransportError, thrift::ProtocolError and thrift::ApplicationError into thrift::Error.

§Examples

Create a TransportError.

use thrift::{TransportError, TransportErrorKind};

// explicit
let err0: thrift::Result<()> = Err(
  thrift::Error::Transport(
    TransportError {
      kind: TransportErrorKind::TimedOut,
      message: format!("connection to server timed out")
    }
  )
);

// use conversion
let err1: thrift::Result<()> = Err(
  thrift::Error::from(
    TransportError {
      kind: TransportErrorKind::TimedOut,
      message: format!("connection to server timed out")
    }
  )
);

// use struct constructor
let err2: thrift::Result<()> = Err(
  thrift::Error::Transport(
    TransportError::new(
      TransportErrorKind::TimedOut,
      "connection to server timed out"
    )
  )
);


// use error variant constructor
let err3: thrift::Result<()> = Err(
  thrift::new_transport_error(
    TransportErrorKind::TimedOut,
    "connection to server timed out"
  )
);

Create an error from a string.

use thrift::{ApplicationError, ApplicationErrorKind};

// we just use `From::from` to convert a `String` into a `thrift::Error`
let err0: thrift::Result<()> = Err(
  thrift::Error::from("This is an error")
);

// err0 is equivalent to...
let err1: thrift::Result<()> = Err(
  thrift::Error::Application(
    ApplicationError {
      kind: ApplicationErrorKind::Unknown,
      message: format!("This is an error")
    }
  )
);

Return an IDL-defined exception.

// Thrift IDL exception definition.
exception Xception {
  1: i32 errorCode,
  2: string message
}
use std::error::Error;
use std::fmt;
use std::fmt::{Display, Formatter};

// auto-generated by the Thrift compiler
#[derive(Clone, Debug, Eq, Ord, PartialEq, PartialOrd)]
pub struct Xception {
  pub error_code: Option<i32>,
  pub message: Option<String>,
}

// auto-generated by the Thrift compiler
impl Error for Xception { }

// auto-generated by the Thrift compiler
impl From<Xception> for thrift::Error {
  fn from(e: Xception) -> Self {
    thrift::Error::User(Box::new(e))
  }
}

// auto-generated by the Thrift compiler
impl Display for Xception {
  fn fmt(&self, f: &mut Formatter) -> fmt::Result {
    write!(f, "remote service threw Xception")
  }
}

// in user code...
let err: thrift::Result<()> = Err(
  thrift::Error::from(Xception { error_code: Some(1), message: None })
);

Variants§

§

Transport(TransportError)

Errors encountered while operating on I/O channels.

These include connection closed and bind failure.

§

Protocol(ProtocolError)

Errors encountered during runtime-library processing.

These include message too large and unsupported protocol version.

§

Application(ApplicationError)

Errors encountered within auto-generated code, or when incoming or outgoing messages violate the Thrift spec.

These include out-of-order messages and missing required struct fields.

This variant also functions as a catch-all: errors from handler functions are automatically returned as an ApplicationError.

§

User(Box<dyn Error + Sync + Send>)

IDL-defined exception structs.

Implementations§

source§

impl Error

source

pub fn read_application_error_from_in_protocol( i: &mut dyn TInputProtocol, ) -> Result<ApplicationError>

Create an ApplicationError from its wire representation.

Application code should never call this method directly.

source

pub fn write_application_error_to_out_protocol( e: &ApplicationError, o: &mut dyn TOutputProtocol, ) -> Result<()>

Convert an ApplicationError into its wire representation and write it to the remote.

Application code should never call this method directly.

Trait Implementations§

source§

impl Debug for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for Error

1.30.0 · source§

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

Returns the lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

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

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

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. Read more
source§

impl<'a> From<&'a str> for Error

source§

fn from(s: &'a str) -> Self

Converts to this type from the input type.
source§

impl From<ApplicationError> for Error

source§

fn from(e: ApplicationError) -> Self

Converts to this type from the input type.
source§

impl From<Error> for Error

source§

fn from(err: Error) -> Self

Converts to this type from the input type.
source§

impl From<FromUtf8Error> for Error

source§

fn from(err: FromUtf8Error) -> Self

Converts to this type from the input type.
source§

impl From<ProtocolError> for Error

source§

fn from(e: ProtocolError) -> Self

Converts to this type from the input type.
source§

impl From<String> for Error

source§

fn from(s: String) -> Self

Converts to this type from the input type.
source§

impl From<TransportError> for Error

source§

fn from(e: TransportError) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl Freeze for Error

§

impl !RefUnwindSafe for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl !UnwindSafe for Error

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.