Struct Headers 

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

Application-defined metadata Reliar does not understand: a validating newtype, never a HashMap alias and never exposed through Deref (ADR 0011). Reserves the entire reliar- prefix (case-insensitive) so framework metadata is never duplicated here — see Metadata for the one canonical source of truth (ADR 0004, §14).

Implementations

impl Headers

pub const RESERVED_PREFIX: &'static str = "reliar-"

Case-insensitively reserved prefix; Self::insert rejects any key starting with it.

pub const MAX_KEY_LEN: usize = 128

Maximum key length in bytes.

pub const MAX_VALUE_LEN: usize = 1024

Maximum value length in bytes.

pub const MAX_COUNT: usize = 32

Maximum number of distinct headers on one envelope.

pub fn insert( &mut self, key: impl Into<String>, value: impl Into<String>, ) -> Result<Option<String>, HeaderError>

Inserts a header, returning the previous value if the key was already present.

Returns Err — never a silent drop or overwrite — for: the reserved reliar- prefix (matched case-insensitively, so Reliar-Correlation-Id is rejected too), an empty key, a key or value containing a control character (including CR/LF — a header-injection surface once a mapper writes the value onto the wire, same rule as crate::CorrelationId, crate::EndpointAddress and crate::ContentType), a key over Self::MAX_KEY_LEN, or a value over Self::MAX_VALUE_LEN. Replacing a key that is already present never counts against Self::MAX_COUNT; adding a genuinely new key while already at the cap does.

Errors

Returns HeaderError for a reserved, empty, control-character-containing, or over-length key, a control-character-containing or over-length value, or a new key that would exceed Self::MAX_COUNT.

pub fn get(&self, key: &str) -> Option<&str>

Looks up a header by exact key.

pub fn remove(&mut self, key: &str) -> Option<String>

Removes a header, returning its value if present.

pub fn len(&self) -> usize

The number of headers stored.

pub fn is_empty(&self) -> bool

Returns true if no headers are stored.

pub fn iter(&self) -> impl Iterator<Item = (&str, &str)>

Iterates over every stored header as borrowed string slices.

Trait Implementations

impl Clone for Headers

fn clone(&self) -> Headers

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Headers

Never derived. Header values are application-supplied and may be secrets (SRS §33, conventions §9): every value prints as <redacted>, keys print verbatim so the shape of a header set is still debuggable.

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

Formats the value using the given formatter.

impl Default for Headers

fn default() -> Headers

Returns the “default value” for a type.

impl Eq for Headers

impl PartialEq for Headers

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Headers