Struct HttpException 

pub struct HttpException {
    pub status: StatusCode,
    pub code: &'static str,
    pub message: String,
    pub details: Option<Value>,
    pub request_id: Option<String>,
}

HttpException

The framework’s primary error type for HTTP responses. Enables controllers to return proper HTTP error responses without manually constructing response objects.

Fields

• status: The HTTP status code
• code: A machine-readable error code for programmatic error handling
• message: A human-readable error message
• details: Optional additional error details (often validation errors)
• request_id: Optional request ID for correlation

Fields

status: StatusCode

code: &'static str

message: String

details: Option<Value>

request_id: Option<String>

Implementations

impl HttpException

pub fn new( status: StatusCode, code: &'static str, message: impl Into<String>, ) -> Self

Generic constructor for creating an HttpException.

Arguments

• status: The HTTP status code
• code: A machine-readable error code
• message: A human-readable error message

pub fn with_details( status: StatusCode, code: &'static str, message: impl Into<String>, details: Value, ) -> Self

Constructor that includes additional error details.

Arguments

• status: The HTTP status code
• code: A machine-readable error code
• message: A human-readable error message
• details: Additional error details (often used for validation errors)

pub fn with_request_id(self, request_id: impl Into<String>) -> Self

Attaches a request ID to the exception for correlation.

pub fn with_optional_request_id(self, request_id: Option<String>) -> Self

Attaches an optional request ID to the exception.

pub fn bad_request(message: impl Into<String>) -> Self

Creates a 400 Bad Request error.

pub fn bad_request_validation(errors: ValidationErrors) -> Self

Creates a 400 Bad Request error with validation errors.

pub fn unauthorized(message: impl Into<String>) -> Self

Creates a 401 Unauthorized error.

pub fn forbidden(message: impl Into<String>) -> Self

Creates a 403 Forbidden error.

pub fn not_found(message: impl Into<String>) -> Self

Creates a 404 Not Found error.

pub fn internal_server_error(message: impl Into<String>) -> Self

Creates a 500 Internal Server Error.

Trait Implementations

impl Clone for HttpException

fn clone(&self) -> HttpException

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpException

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

Formats the value using the given formatter.

impl IntoResponse for HttpException

IntoResponse Implementation

Makes HttpException directly returnable from axum handlers. This enables returning Result<Json<T>, HttpException> from controllers and having axum automatically convert the error into a proper HTTP response.

fn into_response(self) -> Response

Create a response.