auth-foundation/com.okta.authfoundation.credential.jvm/TokenCredentialManager

TokenCredentialManager

class TokenCredentialManager @JvmOverloads constructor(client: OAuth2Client, storage: TokenStorage, defaultIdStore: DefaultCredentialIdStore, onStorageError: Predicate<Exception>? = null) : Closeable

Java-friendly token credential manager for JVM applications.

Provides blocking CRUD operations for credentials, wrapping the cross-platform KmpCredentialManager with AuthFoundationResult for Java interop.

Warning: All public methods use runBlocking internally. Do not call them from a coroutine or a thread that is part of a coroutine dispatcher — this will deadlock. For coroutine-based callers, use KmpCredentialManager directly.

Event listeners can be registered via addEventListener to receive credential lifecycle events.

Parameters

client

The OAuth2Client used for token operations.

storage

The TokenStorage for persisting tokens.

defaultIdStore

Store for the default credential ID.

onStorageError

Optional predicate invoked when a storage operation throws. Return true to retry the failed operation once; return false (or omit) to rethrow. Example: e -> e instanceof java.sql.SQLException

Constructors

TokenCredentialManager

@JvmOverloads

constructor(client: OAuth2Client, storage: TokenStorage, defaultIdStore: DefaultCredentialIdStore, onStorageError: Predicate<Exception>? = null)

Functions

addEventListener

fun addEventListener(listener: Consumer<Event>): Closeable

Registers a listener that is notified whenever a credential lifecycle event occurs.

allIds

fun allIds(): AuthFoundationResult<List<String>>

Returns all stored credential IDs.

open override fun close()

Closes this manager, cancelling event dispatch.

createTokenData

@JvmOverloads

fun createTokenData(accessToken: String, tokenType: String = "Bearer", expiresIn: Int = 3600, scope: String? = null, refreshToken: String? = null, idToken: String? = null, deviceSecret: String? = null): TokenData

Creates a TokenData from raw token fields. Convenience method for Java callers.

delete