Struct OperationOutcomeError 

pub struct OperationOutcomeError(/* private fields */);

A failure as a FHIR OperationOutcome, with the HTTP status it answers and a record of where it came from.

Boxed so that a Result<T, OperationOutcomeError> is no larger than T needs: the Ok path pays nothing for the error’s bookkeeping.

Implementations

impl OperationOutcomeError

pub fn status(&self) -> StatusCode

http_status as a StatusCode.

impl OperationOutcomeError

pub fn capture_backtraces(enabled: bool)

Capture a backtrace for every error that answers 5xx from now on. Off by default: a backtrace costs microseconds to capture and a rejected request does not need one.

pub fn new(source: Option<Source>, outcome: OperationOutcome) -> Self

pub fn unprocessable(outcome: OperationOutcome) -> Self

An error that answers 422 Unprocessable Entity whatever its issue codes: the request is well formed but cannot be processed as it is, such as a resource that violates an applicable profile.

pub fn fatal(code: BoundCode<IssueType>, diagnostic: String) -> Self

pub fn error(code: BoundCode<IssueType>, diagnostic: String) -> Self

pub fn warning(code: BoundCode<IssueType>, diagnostic: String) -> Self

pub fn information(code: BoundCode<IssueType>, diagnostic: String) -> Self

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

Attach the error this one wraps. Prefer this over formatting the cause into the diagnostic: the client keeps the message you wrote and the log gets the whole chain.

pub fn context(self, message: impl Into<Cow<'static, str>>) -> Self

Record what the caller was doing when the error passed through. Shows up in the log next to the origin; the client never sees it.

pub fn outcome(&self) -> &OperationOutcome

pub fn push_issue(&mut self, issue: OperationOutcomeIssue)

pub fn origin(&self) -> &'static Location<'static>

Where the error was built, or where a ? turned a foreign error into one.

pub fn trail(&self) -> &[Hop]

The context calls the error passed through, innermost first.

pub fn backtrace(&self) -> Option<&Backtrace>

pub fn causes(&self) -> impl Iterator<Item = &(dyn Error + 'static)>

The attached source error and everything it in turn was caused by.

pub fn http_status(&self) -> u16

The HTTP status the error answers with: an override if set, otherwise the status the first issue’s code maps to.

pub fn is_server_error(&self) -> bool

Whether the status is 5xx: the server failed, not the request.

Trait Implementations

impl Debug for OperationOutcomeError

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

Formats the value using the given formatter.

impl Display for OperationOutcomeError

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

Formats the value using the given formatter.

impl Error for OperationOutcomeError

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 IntoResponse for OperationOutcomeError

fn into_response(self) -> Response

Create a response.