Add deterministic random class

[210-reverof]

Summary

Implement DeterministicRandom class with seed-based Random instance caching for deterministic test reproducibility.

Description

• Created DeterministicRandom class that extends Random
  • Automatically caches Random instances using nextLong() generated values as keys
  • Provides getRandomInstance(long seed) to retrieve cached Random instances by seed
  • Provides getCurrentSeedRandom() to get the Random instance for the current seed
  • Implements cache size management with a limit of 32 entries to prevent memory leaks
• Added 7 comprehensive property-based tests using JQwik to verify caching behavior and requirements

How Has This Been Tested?

• Each test runs 1000 iterations with different seed values (7000 total test cases)
• Build verification: ./gradlew :fixture-monkey-api:test passes successfully
• Verified: cache creation on nextLong(), instance retrieval, cache size limit (≤32), deterministic behavior, and seed independence

Is the Document updated?

Not yet.

[seongahjo]

I think it would be better to create a new interface for obtaining the Random instance and the seed value.

It is to avoid using the DeterministicRandom directly.

[210-reverof]

Thank you for your feedback! 🙂

I created a new interface named RandomSource to obtain Random instances and seed values.
I also implemented DeterministicRandomSource that encapsulates the caching logic,
so the internal implementation is no longer exposed.

84e0308