Struct TraitMap 

pub struct TraitMap { /* private fields */ }

A map of traits keyed by their Shape ID.

This provides efficient lookup of traits during serialization and deserialization.

Cross-lifetime lookup

Internal storage is keyed by ShapeId<'static> because traits come from codegen-emitted schemas (themselves 'static). The public get and contains accessors accept &ShapeId<'_> of any lifetime — runtime- built shape IDs (e.g. parsed from a wire-format __type field) are looked up against the 'static-keyed table via ShapeId’s Borrow<str> impl, which keys on the fully qualified name.

Implementations

impl TraitMap

pub const EMPTY: Self

An empty trait map for use in const contexts (e.g. prelude schemas).

pub fn new() -> Self

Creates a new empty TraitMap.

pub fn insert(&mut self, trait_obj: Box<dyn Trait>)

Inserts a trait into the map.

pub fn get(&self, id: &ShapeId<'_>) -> Option<&dyn Trait>

Gets a trait by its Shape ID.

Accepts a ShapeId of any lifetime — lookup is by fully qualified name. A ShapeId<'static> constructed via the shape_id! macro and a runtime-built ShapeId<'_> with the same FQN resolve to the same entry.

pub fn get_fqn(&self, fqn: &str) -> Option<&dyn Trait>

Looks up a trait by its fully qualified name (e.g. "smithy.api#sensitive").

Equivalent to Self::get when the caller already has the FQN as a string slice — for example, after extracting the __type field from a JSON document.

Example

use aws_smithy_schema::traits::JsonNameTrait;
use aws_smithy_schema::{shape_id, ShapeId, TraitMap};

let mut traits = TraitMap::new();
traits.insert(Box::new(JsonNameTrait::new("custom_name")));

// Cross-lifetime: a static-lifetime ShapeId from `shape_id!` and a
// runtime-built ShapeId<'_> with the same FQN both resolve via
// `Borrow<str>`. The companion `_fqn` accessor takes `&str` directly.
assert!(traits.get(&shape_id!("smithy.api", "jsonName")).is_some());
assert!(traits.get_fqn("smithy.api#jsonName").is_some());

pub fn contains(&self, id: &ShapeId<'_>) -> bool

Returns true if the map contains a trait with the given Shape ID.

Accepts a ShapeId of any lifetime; see Self::get.

pub fn contains_fqn(&self, fqn: &str) -> bool

Returns true if the map contains a trait with the given fully qualified name. See Self::get_fqn.

pub fn len(&self) -> usize

Returns the number of traits in the map.

pub fn is_empty(&self) -> bool

Returns true if the map is empty.

Trait Implementations

impl Debug for TraitMap

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

Formats the value using the given formatter.

impl Default for TraitMap

fn default() -> Self

Returns the “default value” for a type.