Struct PathMapping 

pub struct PathMapping {
    pub bucket_segments: usize,
    pub bucket_separator: String,
    pub display_bucket_segments: usize,
}

Defines how URL path segments map to internal bucket names.

Fields

bucket_segments: usize

Number of path segments that form the “bucket” portion. E.g., 2 for /{account}/{product}/...

bucket_separator: String

Separator to join segments into an internal bucket name. E.g., “:” produces account:product.

display_bucket_segments: usize

How many leading segments form the “display bucket” name for XML responses. E.g., 1 means <Name> shows just account.

Implementations

impl PathMapping

pub fn parse(&self, path: &str) -> Option<MappedPath>

Parse a URL path into a MappedPath.

The path is expected to start with /. Segments are split on /, and the first bucket_segments segments form the internal bucket name. Any remaining content becomes the key.

Returns None if there are fewer than bucket_segments non-empty segments.

pub fn parse_bucket_name(&self, bucket_name: &str) -> Option<MappedPath>

Parse a bucket name (e.g., “account:product”) back into a MappedPath.

Used by MappedRegistry when it receives an already-mapped bucket name. Returns None if the bucket name does not split into exactly bucket_segments parts.

pub fn rewrite_request(&self, path: &str, query: Option<&str>) -> RewriteResult

Rewrite an incoming request path and query string for the gateway.

Translates hierarchical paths into internal single-segment bucket paths:

1. Path-based: if the path has enough segments, they are joined into a single bucket name. /{a}/{b}/{key} → /{a:b}/{key}

2. Prefix-based: if the path has fewer segments than required but the query string contains a list-type= param with a non-empty prefix=, the first component of the prefix is folded into the bucket name. /{a}?list-type=2&prefix=b/sub/ → /{a:b}?list-type=2&prefix=sub/

3. Pass-through: all other paths are returned unchanged. Route handlers or the gateway itself will handle them.

pub fn rewrite_copy_source(&self, copy_source: &str) -> Option<String>

Rewrite an x-amz-copy-source header value into the gateway’s bucket namespace.

CopyObject names its source in a header rather than the URL, so rewrite_request never sees it and the gateway would otherwise resolve a client-facing name (alukach) that the registry has never heard of. Feed the result to RequestInfo::with_copy_source alongside the untouched header, which stays as sent for SigV4 verification.

/{a}/{b}/{key}[?versionId=id] → /{a:b}/{key}[?versionId=id]. The key keeps its percent-encoding (only leading segments are rewritten), and the versionId suffix rides through. Returns None when the value has too few segments to map, leaving the caller to pass the header through unchanged.

Trait Implementations

impl Clone for PathMapping

fn clone(&self) -> PathMapping

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathMapping

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

Formats the value using the given formatter.