Struct VersionNegotiator 

pub struct VersionNegotiator { /* private fields */ }

版本协商器

从请求中提取 API 版本号，按配置的策略顺序尝试。

Implementations

impl VersionNegotiator

pub fn new(default_version: ApiVersion) -> Self

创建新的版本协商器

pub fn with_supported_versions(self, versions: Vec<ApiVersion>) -> Self

设置支持的版本列表

pub fn with_strategies(self, strategies: Vec<VersionStrategy>) -> Self

设置策略优先级顺序

pub fn with_url_prefix(self, prefix: impl Into<String>) -> Self

设置 URL 路径前缀（如 api、v 等）

pub fn with_query_param(self, name: impl Into<String>) -> Self

设置 query 参数名

pub fn with_header_name(self, name: impl Into<String>) -> Self

设置自定义 header 名

pub fn negotiate( &self, uri: &Uri, headers: &HeaderMap, ) -> Result<ApiVersion, VersionError>

从请求中协商版本号

按策略顺序尝试，首个成功的版本号即为协商结果。 若所有策略都未匹配，返回默认版本。

返回

• Ok(ApiVersion)：协商成功（可能是匹配的版本或默认版本）
• Err(VersionError)：客户端指定了不支持的版本

Trait Implementations

impl Clone for VersionNegotiator

fn clone(&self) -> VersionNegotiator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionNegotiator

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

Formats the value using the given formatter.

impl Default for VersionNegotiator

fn default() -> Self

Returns the “default value” for a type.