Struct tower_cookies::Cookies

pub struct Cookies { /* private fields */ }

A parsed on-demand cookie jar.

Implementations

impl Cookies

pub fn add(&self, cookie: Cookie<'static>)

Adds Cookie to this jar. If a Cookie with the same name already exists, it is replaced with provided cookie.

pub fn get(&self, name: &str) -> Option<Cookie<'_>>

Returns the Cookie with the given name. Returns None if it doesn’t exist.

pub fn remove(&self, cookie: Cookie<'static>)

Removes Cookie from this jar.

pub fn list(&self) -> Vec<Cookie<'_>>

Returns all the Cookies present in this jar.

This method collects Cookies into a vector instead of iterating through them to minimize the mutex locking time.

pub fn signed<'a>(&self, key: &'a Key) -> SignedCookies<'a>

Returns a child SignedCookies jar for interations with signed by the key cookies.

Example:

use cookie::{Cookie, Key};
use tower_cookies::Cookies;

let cookies = Cookies::default();
let key = Key::generate();
let signed = cookies.signed(&key);

let foo = Cookie::new("foo", "bar");
signed.add(foo.clone());

assert_eq!(signed.get("foo"), Some(foo.clone()));
assert_ne!(cookies.get("foo"), Some(foo));

Trait Implementations

impl Clone for Cookies

fn clone(&self) -> Cookies

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cookies

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

Formats the value using the given formatter.

impl Default for Cookies

fn default() -> Cookies

Returns the “default value” for a type.

impl<S> FromRequestParts<S> for Cookies

where S: Sync + Send,

type Rejection = (StatusCode, &'static str)

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

fn from_request_parts<'life0, 'life1, 'async_trait>( parts: &'life0 mut Parts, _state: &'life1 S ) -> Pin<Box<dyn Future<Output = Result<Self, Self::Rejection>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Perform the extraction.