Enum CamelError 

#[non_exhaustive]
pub enum CamelError {
    ComponentNotFound(String),
    EndpointCreationFailed(String),
    EndpointCreationFailedWithSource(String, OpaqueErrorSource),
    ProcessorError(String),
    ProcessorErrorWithSource(String, Arc<dyn Error + Send + Sync>),
    TypeConversionFailed(String),
    InvalidUri(String),
    ChannelClosed,
    RouteError(String),
    Io(String),
    DeadLetterChannelFailed(String),
    CircuitOpen(String),
    HttpOperationFailed {
        method: String,
        url: String,
        status_code: u16,
        status_text: String,
        response_body: Option<String>,
    },
    ConsumerStopping,
    Config(String),
    ConfigValidation(ConfigValidationError),
    AlreadyConsumed,
    StreamLimitExceeded(usize),
    Unauthenticated(String),
    Unauthorized(String),
    AuthProviderUnavailable(String),
    ValidationError(String),
    TemplateReload(String),
    EndpointUri(EndpointUriError),
    UnsupportedMediaType {
        consumed: String,
        declared: String,
    },
    NotAcceptable {
        accept: String,
        produced: String,
    },
}

Core error type for the Camel framework.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ComponentNotFound(String)

EndpointCreationFailed(String)

EndpointCreationFailedWithSource(String, OpaqueErrorSource)

Like EndpointCreationFailed but preserves the source error chain for downstream inspection (e.g. typed gate-rejection classification).

ProcessorError(String)

ProcessorErrorWithSource(String, Arc<dyn Error + Send + Sync>)

Like ProcessorError but preserves the source error chain for downstream inspection (e.g. via std::error::Error::source()).

TypeConversionFailed(String)

InvalidUri(String)

ChannelClosed

RouteError(String)

Io(String)

DeadLetterChannelFailed(String)

CircuitOpen(String)

HttpOperationFailed

Fields

method: String

url: String

status_code: u16

status_text: String

response_body: Option<String>

ConsumerStopping

Producer call() failed on a shutdown signal — the consumer/semaphore is closing and the producer cannot acquire a permit. Distinct from Stop EIP (which is successful control flow). Used by JMS/OpenSearch producers. See ADR-0024.

Config(String)

ConfigValidation(ConfigValidationError)

Typed security-validation error (ADR-0033). Promotes Batch 1+ config/startup failure modes from stringly-typed Config(_) to a matchable enum so operators can discriminate programmatically.

AlreadyConsumed

StreamLimitExceeded(usize)

Unauthenticated(String)

Unauthorized(String)

AuthProviderUnavailable(String)

Auth provider (JWKS/introspection/token endpoint) is unreachable or failing. Promotes the auth-provider-down signal from a stringly-typed ProcessorError to a matchable variant; WebSocket and gRPC transports map it to 503 / UNAVAILABLE.

ValidationError(String)

TemplateReload(String)

EndpointUri(EndpointUriError)

Typed endpoint-URI construction error (see EndpointUriError). Promotes the fail-closed EndpointUri merge failures from stringly-typed errors to a matchable variant so operators can discriminate programmatically.

UnsupportedMediaType

The request body media type does not match the declared/consumed type (REST DSL default-strict content negotiation, HTTP 415).

Fields

consumed: String

declared: String

NotAcceptable

The response representation cannot satisfy the client’s Accept header (REST DSL default-strict content negotiation, HTTP 406).

Fields

accept: String

produced: String

Implementations

impl CamelError

pub fn classify(&self) -> &'static str

pub fn variant_name(&self) -> &'static str

Stable variant name used by doTry catch-by-variant matchers.

ProcessorErrorWithSource and AuthProviderUnavailable alias to "ProcessorError", and EndpointCreationFailedWithSource aliases to "EndpointCreationFailed" — the aliased variants are not distinguishable by name in MVP (see spec §5.4), so existing doTry catch handlers keep matching.

The enum is #[non_exhaustive]; this match lives in the defining crate (camel-api), so internal exhaustive matching is allowed. Adding a new variant without updating this method will fail to compile, surfaced by variant_name_tests.

Trait Implementations

impl Clone for CamelError

Manual Clone impl: every arm clones its fields normally, except EndpointCreationFailedWithSource, which duplicates the opaque source handle via the crate-private OpaqueErrorSource::clone_handle (the wrapper itself is deliberately not Clone). Exhaustive like variant_name() — a new variant without an arm fails compilation.

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CamelError

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

Formats the value using the given formatter.

impl Display for CamelError

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

Formats the value using the given formatter.

impl Error for CamelError

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<ConfigValidationError> for CamelError

fn from(e: ConfigValidationError) -> Self

Converts to this type from the input type.

impl From<EndpointUriError> for CamelError

fn from(e: EndpointUriError) -> Self

Converts to this type from the input type.

impl From<Error> for CamelError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<TemplateError> for CamelError

fn from(err: TemplateError) -> Self

Converts to this type from the input type.