Enum axum_sqlx_tx::Error

pub enum Error {
    MissingExtension,
    OverlappingExtractors,
    Database {
        error: Error,
    },
}

Possible errors when extracting Tx from a request.

axum requires that the FromRequest Rejection implements IntoResponse, which this does by returning the Display representation of the variant. Note that this means returning configuration and database errors to clients, but you can override the type of error that Tx::from_request returns using the E generic parameter:

use axum::response::IntoResponse;
use axum_sqlx_tx::Tx;
use sqlx::Sqlite;

struct MyError(axum_sqlx_tx::Error);

// The error type must implement From<axum_sqlx_tx::Error>
impl From<axum_sqlx_tx::Error> for MyError {
    fn from(error: axum_sqlx_tx::Error) -> Self {
        Self(error)
    }
}

// The error type must implement IntoResponse
impl IntoResponse for MyError {
    fn into_response(self) -> axum::response::Response {
        (http::StatusCode::INTERNAL_SERVER_ERROR, "internal server error").into_response()
    }
}

async fn handler(tx: Tx<Sqlite, MyError>) {
    /* ... */
}

Variants

MissingExtension

Indicates that the Layer middleware was not installed.

OverlappingExtractors

Indicates that Tx was extracted multiple times in a single handler/middleware.

Database

Fields

error: Error

A database error occurred when starting the transaction.

Trait Implementations

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)>

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(source: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

fn into_response(self) -> Response

Create a response.