Class InMemoryCredentialStore

java.lang.Object

com.svenruppert.jsentinel.credential.store.InMemoryCredentialStore

All Implemented Interfaces:

CredentialStore

public final class InMemoryCredentialStore
extends Object
implements CredentialStore

In-memory CredentialStore backed by ConcurrentHashMap, suitable for tests, demos and small single-node deployments.

The CAS is implemented through ConcurrentHashMap.replace(Object, Object, Object) which uses the record's identity comparison — record equality is value-based, so two records with the same field values are considered equal. That means concurrent updates pinning the same witness deterministically resolve to a single winner (CWE-362).

Constructor Summary

Constructors

Constructor	Description
InMemoryCredentialStore()

Method Summary

Modifier and Type	Method	Description
Optional<CredentialRecord>	findByUsername(String username)	Looks up the credential row for username.
CredentialRecord	register(CredentialRecord record)	Inserts a new record.
int	size()	Test/demo helper: number of records currently held.
CredentialUpdateResult	updateHashIfCurrent(String username, String expectedEncodedHash, String newEncodedHash, Instant when)	Atomically replaces the stored hash if it still matches expectedEncodedHash.
CredentialUpdateResult	updateStatusIfCurrent(String username, CredentialStatus expectedStatus, CredentialStatus newStatus, Instant when)	Atomically replaces the stored status if it still matches expectedStatus.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

InMemoryCredentialStore

public InMemoryCredentialStore()

Method Details

register

public CredentialRecord register(CredentialRecord record)

Inserts a new record. Throws when a record under the same username already exists; the test fixtures expect callers to be explicit.

findByUsername

public Optional<CredentialRecord> findByUsername(String username)

Description copied from interface: CredentialStore

Looks up the credential row for username. Returns Optional.empty() when the username is unknown.

Specified by:

findByUsername in interface CredentialStore

updateHashIfCurrent

public CredentialUpdateResult updateHashIfCurrent(String username,
 String expectedEncodedHash,
 String newEncodedHash,
 Instant when)

Description copied from interface: CredentialStore

Atomically replaces the stored hash if it still matches expectedEncodedHash.

Specified by:

updateHashIfCurrent in interface CredentialStore

Parameters:

username - credential identifier

expectedEncodedHash - witness; usually the encodedHash that findByUsername just returned

newEncodedHash - new envelope to persist

when - timestamp for updatedAt; the store does not call Instant.now() itself so callers can inject a clock

updateStatusIfCurrent

public CredentialUpdateResult updateStatusIfCurrent(String username,
 CredentialStatus expectedStatus,
 CredentialStatus newStatus,
 Instant when)

Description copied from interface: CredentialStore

Atomically replaces the stored status if it still matches expectedStatus.

Specified by:

updateStatusIfCurrent in interface CredentialStore

size

public int size()

Test/demo helper: number of records currently held.