ITokenCacheAccessContext Antarmuka

Paket:

com.microsoft.aad.msal4j

Maven Artifact:

com.microsoft.azure:msal4j:1.26.0

public interface ITokenCacheAccessContext

Antarmuka yang mewakili konteks di mana cache token diakses.

Ketika MSAL mengakses cache token (sebelum atau sesudah), MSAL menyediakan instans antarmuka ini ke aplikasi melalui ITokenCacheAccessAspect metode. Ini memungkinkan aplikasi untuk mendapatkan informasi tentang operasi akses cache yang sedang dilakukan, seperti klien dan akun mana yang terlibat, dan apakah operasi memodifikasi cache.

Konteks ini sangat berguna untuk aplikasi yang menerapkan serialisasi cache token dan strategi persistensi, karena membantu menentukan kapan cache harus dimuat dari atau disimpan ke penyimpanan persisten.

Untuk detail selengkapnya, lihat https://aka.ms/msal4j-token-cache

Ringkasan Metode

Pemodifikasi dan Jenis	Metode dan Deskripsi
abstract IAccount	account() Mendapatkan akun yang terkait dengan operasi akses cache saat ini, jika ada.
abstract java.lang.String	clientId() Mendapatkan ID klien yang terkait dengan operasi akses cache saat ini.
abstract boolean	hasCacheChanged() Menunjukkan apakah cache dimodifikasi selama operasi ini.
abstract ITokenCache	tokenCache() Mendapatkan instans cache token yang diakses.

Detail Metode

account

public abstract IAccount account()

Mendapatkan akun yang terkait dengan operasi akses cache saat ini, jika ada.

Ini mungkin null untuk operasi yang tidak spesifik untuk akun pengguna, seperti permintaan token alur kredensial klien.

Mengembalikan:

IAccount Instans yang terkait dengan akses cache ini, atau null jika operasi tidak spesifik akun.

clientId

public abstract String clientId()

Mendapatkan ID klien yang terkait dengan operasi akses cache saat ini.

Ini mengidentifikasi aplikasi klien mana (terdaftar di Azure AD) yang melakukan akses cache. Dalam skenario multi-penyewa atau multi-klien, aplikasi mungkin ingin mempartisi cache token mereka dengan ID klien.

Mengembalikan:

ID klien (ID aplikasi) seperti yang terdaftar di portal Azure.

hasCacheChanged

public abstract boolean hasCacheChanged()

Menunjukkan apakah cache dimodifikasi selama operasi ini.

Ini sangat berguna dalam ITokenCacheAccessAspect#afterCacheAccess metode untuk menentukan apakah cache harus dipertahankan. Jika tidak ada perubahan yang dilakukan pada cache, aplikasi dapat menghindari operasi tulis yang tidak perlu.

Mengembalikan:

true jika cache dimodifikasi selama operasi ini, jika tidak salah.

tokenCache

public abstract ITokenCache tokenCache()

Mendapatkan instans cache token yang diakses.

Ini dapat digunakan untuk membaca atau mengubah entri cache selama operasi akses cache.

Mengembalikan:

ITokenCache Instans yang sedang diakses.