ITokenCacheAccessContext Interface

Pakket:

com.microsoft.aad.msal4j

Maven-artefact:

com.microsoft.azure:msal4j:1.26.0

public interface ITokenCacheAccessContext

Interface die de context vertegenwoordigt waarin de tokencache wordt geopend.

Wanneer MSAL toegang krijgt tot de tokencache (vóór of na), biedt het een exemplaar van deze interface aan de toepassing via ITokenCacheAccessAspect methoden. Hierdoor kan de toepassing informatie ophalen over de cachetoegangsbewerking die wordt uitgevoerd, zoals welke client en welk account erbij betrokken zijn, en of de bewerking de cache heeft gewijzigd.

Deze context is met name handig voor toepassingen die serialisatie- en persistentiestrategieën voor tokencaches implementeren, omdat hiermee wordt bepaald wanneer de cache moet worden geladen van of opgeslagen in permanente opslag.

Zie https://aka.ms/msal4j-token-cache voor meer informatie

Methodesamenvatting

Modifier en type	Methode en beschrijving
abstract IAccount	account() Hiermee wordt het account dat is gekoppeld aan de huidige cachetoegangsbewerking, indien van toepassing, opgevraagd.
abstract java.lang.String	clientId() Hiermee haalt u de client-id op die is gekoppeld aan de huidige cachetoegangsbewerking.
abstract boolean	hasCacheChanged() Geeft aan of de cache tijdens deze bewerking is gewijzigd.
abstract ITokenCache	tokenCache() Hiermee wordt het tokencache-exemplaar opgehaald dat wordt geopend.

Methodedetails

account

public abstract IAccount account()

Hiermee wordt het account dat is gekoppeld aan de huidige cachetoegangsbewerking, indien van toepassing, opgevraagd.

Dit kan null zijn voor bewerkingen die niet specifiek zijn voor een gebruikersaccount, zoals aanvragen voor clientreferentiestroomtoken.

Retouren:

Het IAccount exemplaar dat is gerelateerd aan deze cachetoegang of null als de bewerking niet accountspecifiek is.

clientId

public abstract String clientId()

Hiermee haalt u de client-id op die is gekoppeld aan de huidige cachetoegangsbewerking.

Hiermee wordt aangegeven welke clienttoepassing (geregistreerd in Azure AD) de cachetoegang uitvoert. In scenario's met meerdere tenants of meerdere clients willen toepassingen mogelijk hun tokencache partitioneren op client-id.

Retouren:

De client-id (toepassings-id) die is geregistreerd in de Azure-portal.

hasCacheChanged

public abstract boolean hasCacheChanged()

Geeft aan of de cache tijdens deze bewerking is gewijzigd.

Dit is met name handig in de ITokenCacheAccessAspect#afterCacheAccess methode om te bepalen of de cache moet worden bewaard. Als er geen wijzigingen zijn aangebracht in de cache, kunnen toepassingen onnodige schrijfbewerkingen voorkomen.

Retouren:

waar als de cache tijdens deze bewerking is gewijzigd, anders onwaar.

tokenCache

public abstract ITokenCache tokenCache()

Hiermee wordt het tokencache-exemplaar opgehaald dat wordt geopend.

Dit kan worden gebruikt om de cachevermeldingen te lezen of te wijzigen tijdens een cachetoegangsbewerking.

Retouren:

Het ITokenCache exemplaar dat wordt geopend.