random: Random vs ThreadLocalRandom vs SecureRandom vs RandomGenerator module (seeds and a 2-output predictor, ranges and measured modulo bias, ThreadLocalRandom limits, SecureRandom algorithms and setSeed behaviour, the 13 java.util.random algorithms with split/jump, indicative timings), 16 contract tests
Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_017ic4b6F5pq1M5ni1bNw8gr
This commit is contained in:
@@ -0,0 +1,37 @@
|
||||
# random
|
||||
|
||||
Companion code for the ankurm.com post *"Random vs ThreadLocalRandom vs SecureRandom vs RandomGenerator in Java."*
|
||||
Module in `java-core-examples`, the Java-core series. All explanation lives in the post; this module holds the code and the captured output.
|
||||
|
||||
## Versions this was built and tested against
|
||||
|
||||
| Component | Version | Notes |
|
||||
|---|---|---|
|
||||
| JDK | 25.0.5.1 (Temurin, LTS) | `java.util.random` (JEP 356) arrived in JDK 17; `ThreadLocalRandom` in Java 7. |
|
||||
| JUnit Jupiter | 5.11.0 | |
|
||||
| Maven | 3.9.11 | |
|
||||
|
||||
## Quickstart
|
||||
|
||||
```bash
|
||||
export JAVA_HOME=/path/to/jdk-25
|
||||
mvn compile
|
||||
scripts/run.sh SeedDemo # one demo
|
||||
scripts/run-all.sh # regenerate every file in output/
|
||||
```
|
||||
|
||||
## What's in here
|
||||
|
||||
| File | What it shows | Output |
|
||||
|---|---|---|
|
||||
| `SeedDemo.java` + `Predictor.java` | Same seed, same sequence; `setSeed`; two `nextInt()` results predict the third. | `output/01` |
|
||||
| `RangeDemo.java` | `nextInt(origin, bound)`, the error messages, `% n` going negative, `Math.abs(MIN_VALUE)`, modulo bias measured. | `output/02` |
|
||||
| `ThreadLocalDemo.java` | `current()`, `setSeed` refused, one stream per thread, virtual threads. | `output/03` |
|
||||
| `SecureRandomDemo.java` | Which algorithm you get, `getInstanceStrong()`, tokens, what `setSeed` does. | `output/04` |
|
||||
| `RandomGeneratorDemo.java` | The interface, the default, the 13 algorithms in JDK 25, split and jump. | `output/05` |
|
||||
| `BenchmarkDemo.java` | Indicative timings (not JMH). Drifts between runs. | `output/06` |
|
||||
| `RandomContractTest.java` | Pins every claim above as an assertion, 16/16 passing. | `output/07` |
|
||||
|
||||
## License
|
||||
|
||||
MIT - see the [repo-wide LICENSE](../LICENSE).
|
||||
Reference in New Issue
Block a user