Enum ServerError 

pub enum ServerError {
    Config {
        message: String,
    },
    TransportBind {
        transport: &'static str,
        address: SocketAddr,
        message: String,
    },
    Transport {
        transport: &'static str,
        message: String,
    },
    SignalListener {
        listener: &'static str,
        message: String,
    },
    Namespace {
        message: String,
    },
    EngineCall {
        source: EngineError,
    },
    StoreBackend {
        source: StoreError,
    },
    Stream {
        failure: StreamFailure,
    },
    WorkerDispatch {
        namespace: String,
        activity_type: String,
        reason: String,
    },
    LockPoisoned {
        resource: &'static str,
    },
    Wire {
        wire: WireError,
    },
}

Server-library error taxonomy.

Variants

Config

Operator configuration could not be loaded or validated.

Fields

message: String

Redacted, operator-facing failure message.

TransportBind

A transport listener could not bind or start.

Fields

transport: &'static str

Transport name.

address: SocketAddr

Configured listener address.

message: String

Redacted, operator-facing failure message.

Transport

A running transport task aborted: it panicked or was cancelled.

Fields

transport: &'static str

Transport name.

message: String

Redacted, operator-facing failure message.

SignalListener

A termination-signal listener could not be installed or failed.

Fields

listener: &'static str

Listener name (SIGTERM, SIGINT, or the portable fallback).

message: String

Redacted, operator-facing failure message.

Namespace

Namespace validation or authorization failed.

Fields

message: String

Redacted namespace failure message.

EngineCall

Engine call failed.

Fields

source: EngineError

Typed engine error returned by the embedded engine.

StoreBackend

Store backend call failed before an engine handle was available.

Fields

source: StoreError

Typed store error returned by the configured backend.

Stream

Streaming failure.

Fields

failure: StreamFailure

Stream failure class.

WorkerDispatch

A scheduled activity could not be pushed to a worker.

Fields

namespace: String

Namespace scoped before dispatch.

activity_type: String

Activity type requested by the engine.

reason: String

Redacted dispatch failure reason.

LockPoisoned

A lock was poisoned and the protected state cannot be trusted.

Fields

resource: &'static str

Protected resource name.

Wire

A failure already translated into the public wire taxonomy.

Fields

wire: WireError

Stable wire error.

Implementations

impl ServerError

pub fn to_wire_error(&self) -> WireError

Convert a server error that crosses a transport boundary into the stable public wire taxonomy.

pub const fn is_config(&self) -> bool

Return true when this is an operator configuration failure.

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

Construct a namespace-denied error without embedding authorization logic.

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

Construct a deploy-authorization denial carried on the dedicated deploy_denied wire code (deploy is not a namespace operation).

pub const fn lagged_stream() -> Self

Construct a lagged-stream error.

pub fn worker_dispatch( namespace: impl Into<String>, activity_type: impl Into<String>, reason: impl Into<String>, ) -> Self

Construct a worker-dispatch error.

pub const fn lock_poisoned(resource: &'static str) -> Self

Construct a lock-poison error at the lock boundary.

impl ServerError

pub fn trace_fields(&self) -> ErrorTraceFields<'_>

Return stable typed fields for structured error logging.

Trait Implementations

impl Debug for ServerError

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

Formats the value using the given formatter.

impl Display for ServerError

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

Formats the value using the given formatter.

impl Error for ServerError

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<EngineError> for ServerError

fn from(source: EngineError) -> Self

Converts to this type from the input type.

impl From<StoreError> for ServerError

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl From<WireError> for ServerError

fn from(wire: WireError) -> Self

Converts to this type from the input type.