Struct SoapFault 

pub struct SoapFault {
    pub code: FaultCode,
    pub reason: String,
    pub detail: Option<String>,
    pub detail_xml: Option<String>,
}

Fields

code: FaultCode

reason: String

detail: Option<String>

detail_xml: Option<String>

Raw, verbatim XML to emit as the fault detail child element (not escaped). Takes precedence over detail when both are set.

Implementations

impl SoapFault

pub fn new( code: FaultCode, reason: impl Into<String>, detail: Option<String>, ) -> Self

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

Attach a raw XML child element as the fault detail. The provided XML is emitted VERBATIM inside <env:Detail> (SOAP 1.2) / <detail> (SOAP 1.1) — it is NOT escaped, so the caller MUST supply well-formed XML. Takes precedence over the text detail.

pub fn sender(reason: impl Into<String>) -> Self

pub fn receiver(reason: impl Into<String>) -> Self

pub fn version_mismatch() -> Self

pub fn must_understand(header: &str) -> Self

pub fn action_not_supported(action: &str) -> Self

pub fn to_xml_bytes_versioned(&self, version: &SoapVersion) -> Vec<u8>

Serialize to a complete SOAP envelope. Version determines fault structure and code names. SOAP 1.2 uses nested Code/Reason (existing to_xml_bytes). SOAP 1.1 uses flat faultcode/faultstring per W3C SOAP 1.1 spec Section 4.4.

pub fn to_xml_bytes(&self) -> Vec<u8>

Serialize to a complete SOAP 1.2 envelope XML string. HTTP status is always 500 per W3C SOAP 1.2 spec Section 7.4.2 (FLT-03).

Trait Implementations

impl Clone for SoapFault

fn clone(&self) -> SoapFault

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SoapFault

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

Formats the value using the given formatter.

impl Display for SoapFault

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

Formats the value using the given formatter.

impl Error for SoapFault

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.