Class InMemoryLoginAttemptStore

java.lang.Object

com.svenruppert.jsentinel.bruteforce.InMemoryLoginAttemptStore

All Implemented Interfaces:

LoginAttemptStore

@ExperimentalJSentinelApi
public final class InMemoryLoginAttemptStore
extends Object
implements LoginAttemptStore

In-memory LoginAttemptStore backed by a single ConcurrentHashMap. Suitable for tests, demos, and single-process applications.

Counters and last-failure instants are kept in a private package-local Ledger record, mutated atomically through compute/merge-style map operations.

Constructor Summary

Constructors

Constructor	Description
InMemoryLoginAttemptStore()	Creates an empty store.

Method Summary

Modifier and Type	Method	Description
int	failureCount(LoginAttemptKey key)	Returns the number of failures currently held against key.
Optional<Instant>	lastFailureAt(LoginAttemptKey key)	Returns the timestamp of the most recent failure on key, if any.
void	recordFailure(LoginAttemptKey key, Instant at)	Increments the failure counter for key by one and updates its last-failure instant to at.
void	reset(LoginAttemptKey key)	Clears any state associated with key — used after a successful login to start the counter from zero again.

Methods inherited from class Object

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

Constructor Details

InMemoryLoginAttemptStore

public InMemoryLoginAttemptStore()

Creates an empty store.

Method Details

recordFailure

public void recordFailure(LoginAttemptKey key,
 Instant at)

Description copied from interface: LoginAttemptStore

Increments the failure counter for key by one and updates its last-failure instant to at.

Specified by:

recordFailure in interface LoginAttemptStore

Parameters:

key - failure dimension; must not be null

at - instant the failure occurred; must not be null

failureCount

public int failureCount(LoginAttemptKey key)

Description copied from interface: LoginAttemptStore

Returns the number of failures currently held against key. Zero when the key has never failed or has been LoginAttemptStore.reset(LoginAttemptKey).

Specified by:

failureCount in interface LoginAttemptStore

Parameters:

key - failure dimension; must not be null

Returns:

non-negative failure count

lastFailureAt

public Optional<Instant> lastFailureAt(LoginAttemptKey key)

Description copied from interface: LoginAttemptStore

Returns the timestamp of the most recent failure on key, if any.

Specified by:

lastFailureAt in interface LoginAttemptStore

Parameters:

key - failure dimension; must not be null

Returns:

last failure instant, or empty when never failed

reset

public void reset(LoginAttemptKey key)

Description copied from interface: LoginAttemptStore

Clears any state associated with key — used after a successful login to start the counter from zero again.

Specified by:

reset in interface LoginAttemptStore

Parameters:

key - failure dimension; must not be null