Struct goauth::fetcher::TokenFetcher

pub struct TokenFetcher { /* fields omitted */ }

A TokenFetcher stores a Token on first fetch and will continue returning that token until it needs to be refreshed, as determined by the token’s expires_in field and the configured refresh_buffer.

Specifically on each token fetch request, it will check the current time against the expected time the currently stored token will expire. If it is within the refresh_buffer window, it will fetch a new token, store that (along with the new expired time), and return the new token.

Implementations

impl TokenFetcher

pub fn new(
    jwt: Jwt<JwtClaims>,
    credentials: Credentials,
    refresh_buffer: Duration
) -> TokenFetcher

pub fn with_client(
    client: Client,
    jwt: Jwt<JwtClaims>,
    credentials: Credentials,
    refresh_buffer: Duration
) -> TokenFetcher

pub async fn fetch_token(&self) -> Result<Token>

Returns a token if the token is still considered “valid” per the currently stored token’s expires_in field and the configured refresh_buffer. If it is, return the stored token. If not, fetch a new token, store it, and return the new token.