Struct Builder

pub struct Builder { /* private fields */ }

Builder for ErrorMetadata.

Implementations

impl Builder

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

Sets the error message.

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

Sets the error code.

pub fn custom(self, key: &'static str, value: impl Into<String>) -> Self

Set a custom field on the error metadata

Typically, these will be accessed with an extension trait:

use aws_smithy_types::error::ErrorMetadata;
const HOST_ID: &str = "host_id";
trait S3ErrorExt {
    fn extended_request_id(&self) -> Option<&str>;
}

impl S3ErrorExt for ErrorMetadata {
    fn extended_request_id(&self) -> Option<&str> {
        self.extra(HOST_ID)
    }
}

fn main() {
    // Extension trait must be brought into scope
    use S3ErrorExt;
    let sdk_response: Result<(), ErrorMetadata> = Err(ErrorMetadata::builder().custom(HOST_ID, "x-1234").build());
    if let Err(err) = sdk_response {
        println!("extended request id: {:?}", err.extended_request_id());
    }
}

pub fn build(self) -> ErrorMetadata

Creates the error.

Trait Implementations

impl Debug for Builder

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

Formats the value using the given formatter.

impl Default for Builder

fn default() -> Builder

Returns the “default value” for a type.