Struct Message 

pub struct Message {
    pub headers: HeaderMap,
    pub trailers: HeaderMap,
    /* private fields */
}

Available on crate feature integrity only.

Owned signature context, independent of HTTP versions and body types.

Servers must supply the effective external target URI. The HTTP/1.1 request target alone generally lacks scheme and authority. Only trusted routing/proxy configuration may provide missing context. HTTP/2 uses the same effective URI; pseudo-headers are represented by derived components.

Headers and trailers remain separate: "content-digest" and "content-digest";tr are different covered components. Responses may retain their originating request for ;req components. The snapshot must describe the message actually transmitted, after content coding and header changes.

Fields

headers: HeaderMap

The message’s header section.

trailers: HeaderMap

The message’s trailer section, populated when it becomes available.

Implementations

impl Message

pub fn request( method: Method, target: &str, headers: HeaderMap, ) -> Result<Self, Error>

Creates request context from a method, absolute HTTP(S) URI, and headers. Userinfo and fragments are rejected because they are not HTTP targets.

pub fn from_request<B>( request: &Request<B>, effective_uri: &str, ) -> Result<Self, Error>

Snapshots a request of any body type, including Axum’s non-Sync body. effective_uri supplies the external URI; the original request-target form is also retained for HTTP/1.x @request-target signatures.

pub fn response( status: StatusCode, headers: HeaderMap, request: Option<Self>, ) -> Result<Self, Error>

Creates response context. Supply a request snapshot to enable ;req.

pub fn with_structured_field( self, name: HeaderName, kind: StructuredFieldType, ) -> Self

Registers a field’s actual Structured Fields type for ;sf processing. Digest and signature dictionaries are already registered. Types are never guessed by trying multiple parsers.

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

Supplies the actual protocol-specific request target for @request-target. Prefer @target-uri when signatures must survive HTTP version changes.

pub fn fields(&self, section: FieldSection) -> &HeaderMap

Returns the chosen field section without merging headers and trailers.

pub fn fields_mut(&mut self, section: FieldSection) -> &mut HeaderMap

Returns the chosen mutable field section.

Trait Implementations

impl Clone for Message

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 Message

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

Formats the value using the given formatter.