OAK-12425: opt into Caffeine SYNC without metadata changes

[rishabhdaim]

Allow DocumentNodeStore caches, including LOCAL_DIFF, to opt into Caffeine SYNC through disabled-by-default FT_CAFFEINE_CACHE_OAK-12425 or -Doak.documentMK.caffeineCache=true.

Keep the existing persistent wrapper, metadata, raw values, weights and file format. Feature selection is fixed per builder; changes require recreating the builder/store or restarting the service. Optional ASYNC support follows in #3190.

Document the legacy guavaCache property and verify that throwing SYNC eviction listeners do not fail cache operations.

Validation with Java 17: 52 targeted tests passed; all four system-property combinations verified in fresh JVMs; baseline and license checks passed.

OAK-12425. Depends on #3186. Benchmark results.

Co-Authored-By: OpenAI Codex noreply@openai.com

[rishabhdaim]

Benchmark re-run after the eviction-listener fix

The results were re-run against a11587c20d, which has the always-registered eviction listener. The benchmark in #3174 now forwards evictions for both policies, the same way DocumentNodeStoreBuilder does. The updated tables (medians of 3 runs, 8 threads) are in the #3174 results comment: #3174 (comment)

Summary:

• The listener adds no measurable overhead.
• With the +25% default (320 MB), Caffeine has a higher hit rate in every 2x–10x scenario and 8–34% fewer backend loads.
• Throughput is higher for steady and concurrent reads up to 5x.
• Single-thread invalidation and heavy churn remain slower.

[thomasmueller]

I think a document store team expert needs to review the PR.
Adding the value to the MetadataEntry sounds wrong to me.
Increasing the cache size sounds dangerous (risk of OOME).

[rishabhdaim]

I think a document store team expert needs to review the PR. Adding the value to the MetadataEntry sounds wrong to me. Increasing the cache size sounds dangerous (risk of OOME).

cache size change has been reverted.

[sonarqubecloud]

Quality Gate failed

Failed conditions
C Reliability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE