Struct OciError 

pub struct OciError {
    pub code: OciErrorCode,
    pub message: String,
    pub detail: Option<Value>,
    pub status_override: Option<StatusCode>,
}

The error type returned by every handler in this crate.

It carries both the spec-defined OciErrorCode (which determines the JSON code and HTTP status) and a free-form message. An optional status override covers cases like 405 Method Not Allowed for a manifest DELETE-by-tag, which spec §3.1 doesn’t have a dedicated code for.

Fields

code: OciErrorCode

Spec-defined error code.

message: String

Human-readable message.

detail: Option<Value>

Machine-readable detail, forwarded into the response body.

status_override: Option<StatusCode>

Optional status override (e.g. 405 for DELETE-by-tag).

Implementations

impl OciError

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

Build a new error from a code and message.

pub fn with_detail(self, detail: Value) -> Self

Attach a JSON detail payload to the error.

pub fn with_status(self, status: StatusCode) -> Self

Override the HTTP status independent of the error code’s default.

pub fn status(&self) -> StatusCode

Final HTTP status to return.

pub fn body(&self) -> OciErrorBody

Build the JSON body.

Trait Implementations

impl Clone for OciError

fn clone(&self) -> OciError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OciError

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

Formats the value using the given formatter.

impl Display for OciError

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

Formats the value using the given formatter.

impl Error for OciError

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<BlobStoreError> for OciError

Map a ferro_blob_store::BlobStoreError onto an OciError.

Called at the edge of every handler so the protocol crate can use the workspace-wide Result type while still surfacing spec-shaped responses.

fn from(err: BlobStoreError) -> Self

Converts to this type from the input type.

impl IntoResponse for OciError

fn into_response(self) -> Response

Create a response.