Struct ServiceShapeNamespace 

#[non_exhaustive]
pub struct ServiceShapeNamespace(/* private fields */);

The namespace of the Smithy service shape a client was generated for.

This is the com.amazonaws.dynamodb in com.amazonaws.dynamodb#DynamoDB_20120810. Together with ServiceShapeName it forms the service’s full shape ID; the two are separate entries rather than one because [ConfigBag] is keyed by type, so each protocol loads exactly the facts it needs and new facts stay additive.

Not to be confused with ServiceXmlNamespace, despite the shared word. That one is the @xmlNamespace trait — a URI restXml applies as the default xmlns on root elements — and neither value is derivable from the other. CloudWatch Logs is the clearest illustration: its shape-ID namespace is com.amazonaws.cloudwatchlogs while its @xmlNamespace URI is http://monitoring.amazonaws.com/doc/2014-03-28/. The trait is also optional, carried by roughly half of AWS service shapes, whereas every shape ID has a namespace by construction — which is why this entry is stored unconditionally and ServiceXmlNamespace is not.

Protocols use this as the default namespace when resolving a document type’s shape discriminator. Some services serialize a discriminator as a bare shape name rather than an absolute shape ID — a __type of Widget instead of com.example#Widget — and the receiving client is expected to qualify it with the service’s namespace. Without it a relative discriminator cannot be resolved to a registered type at all.

Stored for the same reason as ServiceShapeName: it is knowable only from the model, and a customer may select a different protocol at runtime via Config::builder().protocol(..) on a client generated for some other protocol. Baking it into a constructor call at codegen time means a swapped-in protocol either gets no value or gets one the caller had to know to supply. Generated clients therefore store it regardless of which protocol they were generated for.

Implementations

impl ServiceShapeNamespace

pub fn new(namespace: impl Into<Cow<'static, str>>) -> Self

Creates a new ServiceShapeNamespace from the Smithy service shape’s namespace.

Accepts a codegen-emitted &'static str as well as a String materialized at runtime from a parsed model.

pub fn as_str(&self) -> &str

Returns the service shape’s namespace.

Trait Implementations

impl Clone for ServiceShapeNamespace

fn clone(&self) -> ServiceShapeNamespace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceShapeNamespace

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

Formats the value using the given formatter.

impl PartialEq for ServiceShapeNamespace

fn eq(&self, other: &ServiceShapeNamespace) -> 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 Storable for ServiceShapeNamespace

type Storer = StoreReplace<ServiceShapeNamespace>

Specify how an item is stored in the config bag, e.g. [StoreReplace] and [StoreAppend]

impl Eq for ServiceShapeNamespace

impl StructuralPartialEq for ServiceShapeNamespace