Struct Extensions 

pub struct Extensions { /* private fields */ }

Available on native and crate feature core only.

Type-safe extension storage

Clone semantics

Extensions uses Arc<Mutex<HashMap>> internally. Cloning an Extensions creates a shared reference to the same backing store — it does NOT deep-copy the stored values. Mutations through one clone are visible through all other clones.

Implementations

impl Extensions

pub fn new() -> Extensions

Create a new Extensions instance

Examples

use reinhardt_http::Extensions;

let extensions = Extensions::new();
assert!(!extensions.contains::<String>());

pub fn insert<T>(&self, value: T)

where T: Send + Sync + 'static,

Insert a value into extensions

Examples

use reinhardt_http::Extensions;

let extensions = Extensions::new();
extensions.insert(42u32);
extensions.insert("hello".to_string());

assert!(extensions.contains::<u32>());
assert!(extensions.contains::<String>());

pub fn get<T>(&self) -> Option<T>

where T: Clone + Send + Sync + 'static,

Get a cloned value from extensions

Examples

use reinhardt_http::Extensions;

let extensions = Extensions::new();
extensions.insert(42u32);

assert_eq!(extensions.get::<u32>(), Some(42));
assert_eq!(extensions.get::<String>(), None);

pub fn contains<T>(&self) -> bool

where T: Send + Sync + 'static,

Check if a value of the given type exists

Examples

use reinhardt_http::Extensions;

let extensions = Extensions::new();
extensions.insert("hello".to_string());

assert!(extensions.contains::<String>());
assert!(!extensions.contains::<u32>());

pub fn remove<T>(&self) -> Option<T>

where T: Send + Sync + 'static,

Remove a value from extensions and return it

Examples

use reinhardt_http::Extensions;

let extensions = Extensions::new();
extensions.insert(42u32);

assert_eq!(extensions.remove::<u32>(), Some(42));
assert!(!extensions.contains::<u32>());
assert_eq!(extensions.remove::<u32>(), None);

pub fn clear(&self)

Clear all extensions

Examples

use reinhardt_http::Extensions;

let extensions = Extensions::new();
extensions.insert(42u32);
extensions.insert("hello".to_string());

assert!(extensions.contains::<u32>());
assert!(extensions.contains::<String>());

extensions.clear();

assert!(!extensions.contains::<u32>());
assert!(!extensions.contains::<String>());

Trait Implementations

impl Clone for Extensions

fn clone(&self) -> Extensions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Extensions

fn default() -> Extensions

Returns the “default value” for a type.