Struct HttpHeaderSanitizer 

pub struct HttpHeaderSanitizer { /* private fields */ }

Sanitizes HTTP header values for logs and diagnostics.

Implementations

impl HttpHeaderSanitizer

pub const fn new(field_sanitizer: FieldSanitizer) -> Self

Creates an HTTP header sanitizer from a core field sanitizer.

Parameters

• field_sanitizer - Core sanitizer used for HTTP header values.

Returns

New HTTP header sanitizer.

pub const fn field_sanitizer(&self) -> &FieldSanitizer

Returns the underlying core field sanitizer.

Returns

Borrowed core field sanitizer.

pub fn field_sanitizer_mut(&mut self) -> &mut FieldSanitizer

Returns the underlying core field sanitizer mutably.

Returns

Mutable core field sanitizer.

pub fn sanitize_value( &self, name: &HeaderName, value: &HeaderValue, match_mode: NameMatchMode, ) -> String

Sanitizes one HTTP header value by header name.

Non-UTF-8 header values are rendered as <non-utf8> before applying sensitive-name masking.

Parameters

• name - HTTP header name.
• value - HTTP header value.
• match_mode - Field-name matching mode for the header name.

Returns

Log-safe header value.

pub fn sanitize_pair( &self, name: &HeaderName, value: &HeaderValue, match_mode: NameMatchMode, ) -> (String, String)

Sanitizes one HTTP header pair.

Parameters

• name - HTTP header name.
• value - HTTP header value.
• match_mode - Field-name matching mode for the header name.

Returns

Owned string pair preserving the header name and sanitizing the value when needed.

pub fn sanitize_headers( &self, headers: &HeaderMap, match_mode: NameMatchMode, ) -> BTreeMap<String, Vec<String>>

Sanitizes an HTTP header map.

Duplicate header values are grouped under the lowercase header name yielded by HeaderName::as_str. The returned map is sorted deterministically for debug output.

Parameters

• headers - HTTP header map to render safely.
• match_mode - Field-name matching mode for header names.

Returns

Log-safe header names and values.

Trait Implementations

impl Clone for HttpHeaderSanitizer

fn clone(&self) -> HttpHeaderSanitizer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpHeaderSanitizer

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

Formats the value using the given formatter.

impl Default for HttpHeaderSanitizer

fn default() -> Self

Creates an HTTP header sanitizer using FieldSanitizer::default.

impl PartialEq for HttpHeaderSanitizer

fn eq(&self, other: &HttpHeaderSanitizer) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for HttpHeaderSanitizer

impl StructuralPartialEq for HttpHeaderSanitizer