Add caching: the Spring cache abstraction, keys, eviction timing and the self-invocation trap

A Spring Boot 4.1.1 module whose test suite is the evidence for the article: 19 tests
producing 22 transcripts under docs/output/, plus 12 documentation chapters.

Findings the build pins:
- @EnableCaching has no exposeProxy attribute; the widely-copied
  @EnableCaching(exposeProxy = true) does not compile.
- Two methods sharing a cache name and an argument type share a key space, and one
  silently serves the other's answers.
- beforeInvocation = true is NOT deferred by TransactionAwareCacheManagerProxy on
  7.0.9 - doEvict picks evictIfPresent, which the decorator does not intercept.
- Four of five invalid declarations start a clean context and throw at the first call.
- Caffeine on the classpath silently displaces the simple provider.
This commit is contained in:
2026-09-12 05:19:22 +00:00
parent 7e1676c763
commit 66208bcd97
76 changed files with 3710 additions and 0 deletions
@@ -0,0 +1,25 @@
# TransactionAwareCacheManagerProxy, and what it does not cover
cacheManager : org.springframework.cache.transaction.TransactionAwareCacheManagerProxy
nameOf(1) -> Alice
after the identical rollback, nameOf(1) -> Alice
The put was registered as a transaction synchronisation and dropped when the
transaction rolled back instead of committing.
--- what it does not cover: beforeInvocation = true ---
inside the same transaction, after an evict declared beforeInvocation=true,
a re-read returns : Bobby
Not the stale value. The eviction was NOT deferred, and the re-read went to
the database and saw the uncommitted row. The reason is in the bytecode:
AbstractCacheInvoker.doEvict(cache, key, immediate) calls evictIfPresent()
when immediate is true and evict() when it is false, and the decorator only
registers a post-commit synchronisation in evict() - evictIfPresent()
delegates straight to the target cache. See docs/output/22-decorator-bytecode.txt.
Two gaps do remain, and they are structural rather than measurable here:
reads are never deferred, so a @Cacheable lookup inside the transaction sees
whatever the shared cache holds; and outside a transaction the proxy is a
pass-through that writes immediately.