ITokenCacheAccessContext Interfaccia

public interface ITokenCacheAccessContext

Interfaccia che rappresenta il contesto in cui si accede alla cache dei token.

Quando MSAL accede alla cache dei token (prima o dopo), fornisce un'istanza di questa interfaccia all'applicazione tramite ITokenCacheAccessAspect metodi. Ciò consente all'applicazione di ottenere informazioni sull'operazione di accesso alla cache da eseguire, ad esempio il client e l'account coinvolti e se l'operazione ha modificato la cache.

Questo contesto è particolarmente utile per le applicazioni che implementano strategie di serializzazione e persistenza della cache dei token, in quanto consente di determinare quando la cache deve essere caricata o salvata nell'archiviazione permanente.

Per informazioni dettagliate, vedi https://aka.ms/msal4j-token-cache

Riepilogo dei metodi

Modificatore e tipo Metodo e descrizione
abstract IAccount account()

Ottiene l'account associato all'operazione di accesso alla cache corrente, se presente.

abstract java.lang.String clientId()

Ottiene l'ID client associato all'operazione di accesso alla cache corrente.

abstract boolean hasCacheChanged()

Indica se la cache è stata modificata durante questa operazione.

abstract ITokenCache tokenCache()

Ottiene l'istanza della cache dei token a cui si accede.

Dettagli metodo

account

public abstract IAccount account()

Ottiene l'account associato all'operazione di accesso alla cache corrente, se presente.

Può essere Null per le operazioni non specifiche di un account utente, ad esempio le richieste di token del flusso di credenziali client.

Valori restituiti:

IAccount Istanza correlata all'accesso alla cache o Null se l'operazione non è specifica dell'account.

clientId

public abstract String clientId()

Ottiene l'ID client associato all'operazione di accesso alla cache corrente.

Identifica l'applicazione client (registrata in Azure AD) che esegue l'accesso alla cache. Negli scenari multi-tenant o multi-client, le applicazioni possono voler partizionare la cache dei token in base all'ID client.

Valori restituiti:

ID client (ID applicazione) registrato nel portale di Azure.

hasCacheChanged

public abstract boolean hasCacheChanged()

Indica se la cache è stata modificata durante questa operazione.

Ciò è particolarmente utile nel ITokenCacheAccessAspect#afterCacheAccess metodo per determinare se la cache deve essere persistente. Se non sono state apportate modifiche alla cache, le applicazioni possono evitare operazioni di scrittura non necessarie.

Valori restituiti:

true se la cache è stata modificata durante questa operazione, false in caso contrario.

tokenCache

public abstract ITokenCache tokenCache()

Ottiene l'istanza della cache dei token a cui si accede.

Può essere usato per leggere o modificare le voci della cache durante un'operazione di accesso alla cache.

Valori restituiti:

ITokenCache Istanza a cui si accede.

Si applica a