Struct ActionError 

pub struct ActionError {
    pub message: String,
    pub kind: ActionKind,
    pub flash_variant: FlashVariant,
    pub redirect_override: Option<String>,
    /* private fields */
}

Action-handler error type. Drives the 303 redirect, the session flash payload, the back-compat query string, and the tracing::error! log line.

Security

message is rendered to users via the flash payload. Consumer templates MUST HTML-escape it (T-180-01). redirect_override is validated as same-origin at use time (T-180-02).

Fields

message: String

User-facing error message. Treat as untrusted; templates must HTML-escape (T-180-01).

kind: ActionKind

Semantic kind used for routing and back-compat query strings.

flash_variant: FlashVariant

Flash banner variant picked up by consumer templates.

redirect_override: Option<String>

Optional redirect override. Validated as same-origin when applied (T-180-02).

Implementations

impl ActionError

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

Generic error — most common constructor.

pub fn validation_failed(redirect_to: impl Into<String>) -> Self

Constructor for handlers that have already flashed per-field validation errors via ValidationError::with_old_input(&data).redirect_to(url) (or equivalently via ValidationError::into_action_error(url)).

Drives the 303 redirect WITHOUT writing the URL ?error=...&msg=... envelope (which would render a redundant generic toast alongside the per-field inline errors). Also skips the _action session flash write.

The 303 status, the Location header, and the tracing::error! log line still emit unconditionally.

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

404-shape error.

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

403-shape error.

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

401-shape error.

redirect_override defaults to None — ferro is project-agnostic and does not hardcode any consumer auth path (D-08). Callers configure the redirect target explicitly: ActionError::unauthorized("...").redirect_to("/your-login-path").

pub fn with_flash(self, variant: FlashVariant) -> Self

Builder — set the flash variant.

pub fn redirect_to(self, url: impl Into<String>) -> Self

Builder — set the redirect override. The override is validated as same-origin (T-180-02) when applied by the action runtime; external URLs are silently rejected and a tracing::warn! is emitted.

Trait Implementations

impl Clone for ActionError

fn clone(&self) -> ActionError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActionError

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

Formats the value using the given formatter.

impl Display for ActionError

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

Formats the value using the given formatter.

impl Error for ActionError

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.

impl From<&'static str> for ActionError

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

Converts to this type from the input type.

impl From<DbErr> for ActionError

fn from(err: DbErr) -> Self

Converts to this type from the input type.

impl From<FrameworkError> for ActionError

fn from(err: FrameworkError) -> Self

Converts to this type from the input type.

impl From<String> for ActionError

fn from(s: String) -> Self

Converts to this type from the input type.