Claude
f8c9e244a3
Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_017ic4b3pDoGLiWk6LLBeHjW
42 lines
2.1 KiB
Markdown
42 lines
2.1 KiB
Markdown
# bufferedreader
|
|
|
|
Companion code for the ankurm.com post *"Java BufferedReader: Read a File Line by Line (vs Scanner, Files.lines and readAllLines)."*
|
|
Module `bufferedreader` in `java-core-examples`. The explanation lives in the post; this module holds the runnable evidence and the captured output.
|
|
|
|
## Versions
|
|
|
|
| Component | Version |
|
|
|---|---|
|
|
| JDK | 25.0.5+8 (Temurin, LTS) |
|
|
| JUnit Jupiter | 5.11.0 |
|
|
| OS | Linux 6.18, 2 vCPU x86-64 VM (timings are indicative, not a leaderboard) |
|
|
| Big file | 1,000,000,064 bytes, 9,623,347 ASCII log lines, generated then deleted by the script |
|
|
|
|
## Quickstart
|
|
|
|
```bash
|
|
export JDK25_HOME=/path/to/jdk-25
|
|
./scripts/run-all.sh # needs ~1.3 GB free in /tmp/bufferedreader-data and ~6 GB RAM; regenerates output/
|
|
BIG_BYTES=200000000 ./scripts/run-all.sh # smaller "big" file if disk or RAM is tight
|
|
mvn -q -pl bufferedreader -am test # 10 assertions, tiny files only
|
|
```
|
|
|
|
## What is in here
|
|
|
|
| File | Shows | Output |
|
|
|---|---|---|
|
|
| `TestData` | deterministic generator: ~100-byte log lines, or one giant line with no newline | `02` |
|
|
| `LineCount` | `BufferedReader`, `Scanner`, `Files.lines`, `Files.readAllLines` on the same file: which survive `-Xmx64m`, what `readAllLines` needs, time and GC | `03`, `04` |
|
|
| `ReadCalls` | read calls that reach the underlying stream, and per-character vs `readLine()` time | `05` |
|
|
| `LongLineDemo` | `readLine()` on one 200 MB line at `-Xmx128m` vs chunked `read(char[])` | `06` |
|
|
| `CharsetDemo` | invalid UTF-8 through five readers, the JDK 18+ default charset, `-Dfile.encoding=COMPAT`, and a UTF-8 BOM | `07`, `08` |
|
|
| `LineEndingsDemo` | `\n`, `\r\n`, `\r`, final newline, empty file: what counts as a line | `09` |
|
|
| `ScannerSwallowsDemo` | a reader that fails mid-file: `BufferedReader` throws, `Scanner` looks like end of file | `10` |
|
|
| `ReadLineContractTest` | 10 assertions behind the claims above | `11` |
|
|
|
|
`01` records the environment. Timings move with whatever else the machine is doing; counts, exceptions, line totals and heap outcomes do not.
|
|
|
|
## License
|
|
|
|
MIT - see [LICENSE](../LICENSE).
|