Struct Shares 

pub struct Shares { /* private fields */ }

Shares this server has minted.

LIMITATION(registre#410): Shares is per-process, so a link minted on one instance does not open on another.

Implementations

impl Shares

pub fn mint(&self, session_id: &str) -> String

Mint a share for a session, or return the one it already has.

Minting twice returns the same link rather than a second one, so a client retrying after a dropped connection does not scatter live links it cannot then revoke.

pub fn for_session(&self, session_id: &str) -> Option<String>

The share a session already has, if any.

pub fn session_of(&self, share_id: &str) -> Option<String>

The session a share opens.

pub fn revoke(&self, session_id: &str) -> bool

Revoke a session’s share, reporting whether there was one.

Revocation kills the link itself, not one holder’s copy of it: the id is removed, so every link ever minted for this session stops opening.

Trait Implementations

impl Debug for Shares

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

Formats the value using the given formatter.

impl Default for Shares

fn default() -> Self

Returns the “default value” for a type.