Struct AcceptHeaderVersioning 

pub struct AcceptHeaderVersioning {
    pub default_version: Option<String>,
    pub allowed_versions: HashSet<String>,
    pub version_param: String,
}

Available on crate feature rest and non-WebAssembly only.

Accept header versioning

Example: Accept: application/json; version=1.0

Fields

default_version: Option<String>

The fallback version when no version is specified in the Accept header.

allowed_versions: HashSet<String>

The set of allowed API versions.

version_param: String

The parameter name to look for in the Accept header (default: "version").

Implementations

impl AcceptHeaderVersioning

pub fn new() -> AcceptHeaderVersioning

Create a new AcceptHeaderVersioning instance

Examples

use reinhardt_rest::versioning::{AcceptHeaderVersioning, BaseVersioning};

let versioning = AcceptHeaderVersioning::new();
assert_eq!(versioning.default_version.as_deref(), None);
assert_eq!(versioning.version_param.as_str(), "version");

pub fn with_default_version( self, version: impl Into<String>, ) -> AcceptHeaderVersioning

Set the default version to use when no version is specified

Examples

use reinhardt_rest::versioning::{AcceptHeaderVersioning, BaseVersioning};

let versioning = AcceptHeaderVersioning::new()
    .with_default_version("1.0");
assert_eq!(versioning.default_version.as_deref(), Some("1.0"));

pub fn with_allowed_versions( self, versions: Vec<impl Into<String>>, ) -> AcceptHeaderVersioning

Set the allowed versions

Examples

use reinhardt_rest::versioning::{AcceptHeaderVersioning, BaseVersioning};

let versioning = AcceptHeaderVersioning::new()
    .with_allowed_versions(vec!["1.0", "2.0", "3.0"]);
assert!(versioning.is_allowed_version("1.0"));
assert!(versioning.is_allowed_version("2.0"));
assert!(!versioning.is_allowed_version("4.0"));

pub fn with_version_param( self, param: impl Into<String>, ) -> AcceptHeaderVersioning

Set the version parameter name to look for in the Accept header

Examples

use reinhardt_rest::versioning::{AcceptHeaderVersioning, BaseVersioning};

let versioning = AcceptHeaderVersioning::new()
    .with_version_param("api-version");
assert_eq!(versioning.version_param.as_str(), "api-version");

Trait Implementations

impl BaseVersioning for AcceptHeaderVersioning

fn determine_version<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 Request, ) -> Pin<Box<dyn Future<Output = Result<String, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, AcceptHeaderVersioning: 'async_trait,

Determine the API version from the request

fn default_version(&self) -> Option<&str>

Get the default version

fn allowed_versions(&self) -> Option<&HashSet<String>>

Get allowed versions

fn version_param(&self) -> &str

Get the version parameter name

fn is_allowed_version(&self, version: &str) -> bool

Check if a version is allowed

impl Clone for AcceptHeaderVersioning

fn clone(&self) -> AcceptHeaderVersioning

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AcceptHeaderVersioning

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

Formats the value using the given formatter.

impl Default for AcceptHeaderVersioning

fn default() -> AcceptHeaderVersioning

Returns the “default value” for a type.