1.1.5.Beta

Fluent Cache Read/Write API

• HotKeyReadQuery — Chain-style multi-level reads with withPrimary, thenExecute, allowNull, allowBroadcast, and orElseThisTime. Preserves L1 caching, hot-key detection, and SingleFlight via HotKey core API.
• HotKeyWriteCommand — Fluent write operations (putThrough, putBeforeInvalidate, invalidate) with TTL overrides. All commands automatically enforce blacklist rules.

Local-Only Writes

• putLocal — Added to HotKeyCache and HotKey facade. Writes to local Caffeine without version bump, broadcast, or hot-key detection. Preserves existing entry metadata.

Broadcast Control

• allowBroadcast / notAllowBroadcast — Callers control whether fallback results are broadcast via putThrough. Default is false (no broadcast), keeping reads silent by default.

Blacklist & Null Handling Fixes

• Blacklist Consistency — putThrough and putBeforeInvalidate now throw HotKeyBlockedException on blocked keys, matching the behavior of get/peek.
• Null Sentinel Unification — All internal null caching uses NullValue.INSTANCE in putThrough and fallback caching, avoiding Caffeine null rejection.

Documentation Clarifications

• No Broadcast on Reads — get and getWithSoftExpire never broadcast; only putThrough/invalidate and explicitly allowBroadcast-enabled fallbacks trigger REFRESH.