ITokenCacheAccessContext Interfaz

public interface ITokenCacheAccessContext

Interfaz que representa el contexto en el que se accede a la caché de tokens.

Cuando MSAL accede a la caché de tokens (antes o después), proporciona una instancia de esta interfaz a la aplicación a través ITokenCacheAccessAspect de métodos. Esto permite a la aplicación obtener información sobre la operación de acceso a la caché que se está realizando, como el cliente y la cuenta implicados, y si la operación modificó la memoria caché.

Este contexto es especialmente útil para las aplicaciones que implementan estrategias de serialización y persistencia de caché de tokens, ya que ayuda a determinar cuándo se debe cargar o guardar la caché en el almacenamiento persistente.

Si desea obtener información más detallada, consulte https://aka.ms/msal4j-token-cache.

Resumen del método

Modificador y tipo Método y descripción
abstract IAccount account()

Obtiene la cuenta asociada a la operación de acceso a la caché actual, si existe.

abstract java.lang.String clientId()

Obtiene el identificador de cliente asociado a la operación de acceso a la caché actual.

abstract boolean hasCacheChanged()

Indica si la memoria caché se modificó durante esta operación.

abstract ITokenCache tokenCache()

Obtiene la instancia de caché de tokens a la que se accede.

Detalles del método

account

public abstract IAccount account()

Obtiene la cuenta asociada a la operación de acceso a la caché actual, si existe.

Esto puede ser null para las operaciones que no son específicas de una cuenta de usuario, como las solicitudes de token de flujo de credenciales de cliente.

Devoluciones:

La IAccount instancia relacionada con este acceso a la memoria caché o null si la operación no es específica de la cuenta.

clientId

public abstract String clientId()

Obtiene el identificador de cliente asociado a la operación de acceso a la caché actual.

Esto identifica qué aplicación cliente (registrada en Azure AD) realiza el acceso a la memoria caché. En escenarios multiinquilino o multi-cliente, es posible que las aplicaciones quieran particionar su caché de tokens por identificador de cliente.

Devoluciones:

Identificador de cliente (id. de aplicación) como se registró en el portal de Azure.

hasCacheChanged

public abstract boolean hasCacheChanged()

Indica si la memoria caché se modificó durante esta operación.

Esto es especialmente útil en el ITokenCacheAccessAspect#afterCacheAccess método para determinar si se debe conservar la memoria caché. Si no se realizaron cambios en la memoria caché, las aplicaciones pueden evitar operaciones de escritura innecesarias.

Devoluciones:

True si la memoria caché se modificó durante esta operación; de lo contrario, false.

tokenCache

public abstract ITokenCache tokenCache()

Obtiene la instancia de caché de tokens a la que se accede.

Esto se puede usar para leer o modificar las entradas de caché durante una operación de acceso a la memoria caché.

Devoluciones:

Instancia ITokenCache a la que se accede.

Se aplica a