Struct ReversibleResourceTemplate 

pub struct ReversibleResourceTemplate { /* private fields */ }

A compiled, deterministic RFC 6570 template suitable for local dispatch.

This is intentionally stricter than UriTemplate. It accepts scalar captures only, requires unambiguous expression boundaries, and decodes captured percent triplets once. Named (;, ?, and &) expressions may contain multiple scalar variables because their wire names make omission and ordering deterministic. List and associative inputs are rejected before expansion because their compact and exploded forms are not generally invertible. An explode modifier on a scalar is admitted: RFC 6570 gives it the same wire form as the unmodified scalar.

Implementations

impl ReversibleResourceTemplate

pub fn compile(template: UriTemplate) -> Result<Self, UriTemplateError>

Compiles an owned template for deterministic reverse matching.

pub fn from_template(template: &UriTemplate) -> Result<Self, UriTemplateError>

Compiles a borrowed template for deterministic reverse matching.

pub fn template(&self) -> &UriTemplate

Returns the original RFC 6570 template.

pub fn expand( &self, values: &TemplateValues, ) -> Result<String, UriTemplateError>

Expands only the scalar value shape declared by this compiled matcher.

pub fn match_uri( &self, uri: &str, ) -> Result<Option<TemplateValues>, UriTemplateError>

Reverse-matches an exact URI wire string and returns its scalar bindings.

Ok(None) means the URI is outside this template’s language. Any successful result is replayed through Self::expand and compared to the original bytes before it is returned.

Trait Implementations

impl Clone for ReversibleResourceTemplate

fn clone(&self) -> ReversibleResourceTemplate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReversibleResourceTemplate

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

Formats the value using the given formatter.

impl Eq for ReversibleResourceTemplate

impl PartialEq for ReversibleResourceTemplate

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReversibleResourceTemplate

impl TryFrom<&UriTemplate> for ReversibleResourceTemplate

type Error = UriTemplateError

The type returned in the event of a conversion error.

fn try_from(template: &UriTemplate) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<UriTemplate> for ReversibleResourceTemplate

type Error = UriTemplateError

The type returned in the event of a conversion error.

fn try_from(template: UriTemplate) -> Result<Self, Self::Error>

Performs the conversion.