Struct QueryError 

pub struct QueryError {
    pub code: ErrorCode,
    pub message: String,
    pub context: ErrorContext,
    pub source: Option<Box<dyn Error + Send + Sync>>,
}

Errors that can occur during query operations.

Fields

code: ErrorCode

The error code.

message: String

The error message.

context: ErrorContext

Additional context.

source: Option<Box<dyn Error + Send + Sync>>

The source error (if any).

Implementations

impl QueryError

pub fn new(code: ErrorCode, message: impl Into<String>) -> Self

Create a new error with the given code and message.

pub fn with_context(self, operation: impl Into<String>) -> Self

Add context about the operation.

pub fn with_suggestion(self, suggestion: impl Into<String>) -> Self

Add a suggestion for fixing the error.

pub fn with_code_suggestion( self, text: impl Into<String>, code: impl Into<String>, ) -> Self

Add a code suggestion.

pub fn with_help(self, help: impl Into<String>) -> Self

Add help text.

pub fn with_model(self, model: impl Into<String>) -> Self

Set the model.

pub fn with_field(self, field: impl Into<String>) -> Self

Set the field.

pub fn with_sql(self, sql: impl Into<String>) -> Self

Set the SQL query.

pub fn with_source<E: Error + Send + Sync + 'static>(self, source: E) -> Self

Set the source error.

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

Create a not found error.

pub fn not_unique(model: impl Into<String>) -> Self

Create a not unique error.

pub fn constraint_violation( model: impl Into<String>, message: impl Into<String>, ) -> Self

Create a constraint violation error.

pub fn unique_violation( model: impl Into<String>, field: impl Into<String>, ) -> Self

Create a unique constraint violation error.

pub fn foreign_key_violation( model: impl Into<String>, relation: impl Into<String>, ) -> Self

Create a foreign key violation error.

pub fn not_null_violation( model: impl Into<String>, field: impl Into<String>, ) -> Self

Create a not null violation error.

pub fn invalid_input( field: impl Into<String>, message: impl Into<String>, ) -> Self

Create an invalid input error.

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

Create a connection error.

pub fn connection_timeout(duration_ms: u64) -> Self

Create a connection timeout error.

pub fn pool_exhausted(max_connections: u32) -> Self

Create a pool exhausted error.

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

Create an authentication error.

pub fn timeout(duration_ms: u64) -> Self

Create a timeout error.

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

Create a transaction error.

pub fn deadlock() -> Self

Create a deadlock error.

pub fn sql_syntax(message: impl Into<String>, sql: impl Into<String>) -> Self

Create an SQL syntax error.

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

Create a serialization error.

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

Create a deserialization error.

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

Create a general database error.

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

Create an internal error.

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

Create an unsupported operation error.

pub fn is_not_found(&self) -> bool

Check if this is a not found error.

pub fn is_constraint_violation(&self) -> bool

Check if this is a constraint violation.

pub fn is_timeout(&self) -> bool

Check if this is a timeout error.

pub fn is_connection_error(&self) -> bool

Check if this is a connection error.

pub fn is_retryable(&self) -> bool

Check if this error is retryable.

pub fn error_code(&self) -> &ErrorCode

Get the error code.

pub fn docs_url(&self) -> String

Get the documentation URL for this error.

pub fn display_full(&self) -> String

Display the full error with all context and suggestions.

pub fn display_colored(&self) -> String

Display error with ANSI colors for terminal output.

Trait Implementations

impl Debug for QueryError

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

Formats the value using the given formatter.

impl Display for QueryError

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

Formats the value using the given formatter.

impl Error for QueryError

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.