ITokenCacheAccessContext Interfejs

Pakiet:

com.microsoft.aad.msal4j

Artefakt Maven:

com.microsoft.azure:msal4j:1.26.0

public interface ITokenCacheAccessContext

Interfejs reprezentujący kontekst, w którym uzyskuje się dostęp do pamięci podręcznej tokenów.

Gdy biblioteka MSAL uzyskuje dostęp do pamięci podręcznej tokenu (przed lub po nim), udostępnia wystąpienie tego interfejsu aplikacji za pomocą ITokenCacheAccessAspect metod. Dzięki temu aplikacja może uzyskać informacje na temat wykonywanej operacji dostępu do pamięci podręcznej, takiej jak klient i konto oraz czy operacja zmodyfikowała pamięć podręczną.

Ten kontekst jest szczególnie przydatny w przypadku aplikacji implementujących strategie serializacji i trwałości pamięci podręcznej tokenu, ponieważ pomaga określić, kiedy pamięć podręczna powinna zostać załadowana z magazynu trwałego lub zapisana w magazynie trwałym.

Aby uzyskać więcej informacji, zobacz https://aka.ms/msal4j-token-cache

Podsumowanie metody

Modyfikator i typ	Metoda i opis
abstract IAccount	account() Pobiera konto skojarzone z bieżącą operacją dostępu do pamięci podręcznej, jeśli istnieje.
abstract java.lang.String	clientId() Pobiera identyfikator klienta skojarzony z bieżącą operacją dostępu do pamięci podręcznej.
abstract boolean	hasCacheChanged() Wskazuje, czy pamięć podręczna została zmodyfikowana podczas tej operacji.
abstract ITokenCache	tokenCache() Pobiera dostęp do wystąpienia pamięci podręcznej tokenu.

Szczegóły metody

account

public abstract IAccount account()

Pobiera konto skojarzone z bieżącą operacją dostępu do pamięci podręcznej, jeśli istnieje.

Może to mieć wartość null dla operacji, które nie są specyficzne dla konta użytkownika, takich jak żądania tokenu przepływu poświadczeń klienta.

Zwraca:

Wystąpienie IAccount związane z tym dostępem do pamięci podręcznej lub ma wartość null, jeśli operacja nie jest specyficzna dla konta.

clientId

public abstract String clientId()

Pobiera identyfikator klienta skojarzony z bieżącą operacją dostępu do pamięci podręcznej.

Określa, która aplikacja kliencka (zarejestrowana w usłudze Azure AD) wykonuje dostęp do pamięci podręcznej. W scenariuszach obejmujących wiele dzierżaw lub wielu klientów aplikacje mogą chcieć partycjonować pamięć podręczną tokenów według identyfikatora klienta.

Zwraca:

Identyfikator klienta (identyfikator aplikacji) zarejestrowany w portalu Azure.

hasCacheChanged

public abstract boolean hasCacheChanged()

Wskazuje, czy pamięć podręczna została zmodyfikowana podczas tej operacji.

Jest to szczególnie przydatne w metodzie ITokenCacheAccessAspect#afterCacheAccess w celu określenia, czy pamięć podręczna powinna być utrwalana. Jeśli w pamięci podręcznej nie wprowadzono żadnych zmian, aplikacje mogą uniknąć niepotrzebnych operacji zapisu.

Zwraca:

wartość true, jeśli pamięć podręczna została zmodyfikowana podczas tej operacji, w przeciwnym razie wartość false.

tokenCache

public abstract ITokenCache tokenCache()

Pobiera dostęp do wystąpienia pamięci podręcznej tokenu.

Może to służyć do odczytywania lub modyfikowania wpisów pamięci podręcznej podczas operacji dostępu do pamięci podręcznej.

Zwraca:

Wystąpienie ITokenCache , do którego jest uzyskiwany dostęp.