de.ipcon.tools

Class UsageStatistics

java.lang.Object

de.ipcon.tools.UsageStatistics

public class UsageStatistics
extends java.lang.Object

A thread-safe class for maintaining usage statistics by Id.

Constructor Summary

Constructors

Constructor and Description
UsageStatistics()

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.Long,java.lang.Integer>	getAndResetUsageStatistics() Retrieves the current state of the usage statistics as a Map.
int	getUsage(java.lang.Long id) Retrieves the current usage count for the given Id.
void	incrementUsage(java.lang.Long id) Increments the usage count for the given Id.
boolean	isEmpty() Returns true if there are currently no statistics entries, false otherwise.
void	printStatistics() Prints all usage statistics.
void	resetStatistics() Resets the internal state of usage statistics.
int	size() Returns the number of current statistics entries.

Methods inherited from class java.lang.Object

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

Constructor Detail

UsageStatistics

public UsageStatistics()

Method Detail

incrementUsage

public void incrementUsage(java.lang.Long id)

Increments the usage count for the given Id. If no entry for the Id exists yet, it initializes the count to 1.

This method uses the readLock to allow concurrent access to the internal (thread-safe) ConcurrentHashMap unless getAndResetUsageStatistics() is called, which acquires the writeLock to copy and reset the internal map, during which no new entries may be added to the internal map.

Parameters:

id - The Id for which to increment the usage count.

isEmpty

public boolean isEmpty()

Returns true if there are currently no statistics entries, false otherwise.

This method checks whether the internal statistics map is empty, indicating whether any usage statistics have been recorded.

Returns:

true if there are currently no statistics entries, false otherwise

size

public int size()

Returns the number of current statistics entries.

This method retrieves the current count of entries in the internal statistics map, indicating how many distinct Ids have recorded usage statistics so far.

Returns:

The number of current statistics entries.

getUsage

public int getUsage(java.lang.Long id)

Retrieves the current usage count for the given Id.

Parameters:

id - The Id for which to get the usage count.

Returns:

The current usage count for the given Id. Returns 0 if no entry for the Id exists.

printStatistics

public void printStatistics()

Prints all usage statistics. Outputs each Id and its corresponding count.

getAndResetUsageStatistics

public java.util.Map<java.lang.Long,java.lang.Integer> getAndResetUsageStatistics()

Retrieves the current state of the usage statistics as a Map. The internal state is then reset.

Returns:

A Map representing the current state of usage statistics.

resetStatistics

public void resetStatistics()

Resets the internal state of usage statistics.