Struct HttpHeaderTrait 

pub struct HttpHeaderTrait<'a> { /* private fields */ }

The @httpHeader trait — binds a member to an HTTP header.

Implementations

impl<'a> HttpHeaderTrait<'a>

pub const TRAIT_ID: ShapeId<'static>

The Shape ID for this trait.

pub const fn new(value: &'static str) -> Self

Creates a new instance from a 'static header name.

Unlike the other wire-format traits this requires 'static, so that value_static can hand the HTTP binder a name it inserts into Headers without allocating. Schemas materialized at runtime must intern or leak their header names; every other wire-format trait accepts an arbitrary lifetime.

pub fn value(&self) -> &'a str

Returns the header name.

Bound to the schema’s data lifetime 'a, matching the other trait wrappers. Use value_static when the name has to outlive the schema, as it does for header insertion.

pub fn value_static(&self) -> Option<&'static str>

Returns the header name if it is 'static.

This is what Headers::insert needs for an allocation-free insert.

Always Some today, because new is the only constructor and it requires 'static. Callers must nonetheless handle None and fall back to an owned string rather than unwrapping: relaxing this trait to accept runtime-borrowed names is intended to be additive, and at that point this returns None for arena-borrowed names.

Trait Implementations

impl<'a> Clone for HttpHeaderTrait<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for HttpHeaderTrait<'a>

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

Formats the value using the given formatter.

impl Trait for HttpHeaderTrait<'static>

fn trait_id(&self) -> &ShapeId<'static>

Returns the Shape ID of this trait.

fn as_any(&self) -> &dyn Any

Returns this trait as &dyn Any for downcasting.