[jira] [Created] (OAK-12147) Introduce Oak Cache API interfaces in oak-core-spi

["Rishabh Daim (Jira)" <ji...@apache.org>]

Rishabh Daim created OAK-12147:
----------------------------------

             Summary: Introduce Oak Cache API interfaces in oak-core-spi
                 Key: OAK-12147
                 URL: https://issues.apache.org/jira/browse/OAK-12147
             Project: Jackrabbit Oak
          Issue Type: Sub-task
            Reporter: Rishabh Daim
            Assignee: Rishabh Daim


Introduce a new Oak-owned cache API in oak-core-spi so that all Oak modules can depend on stable interfaces rather than Guava shim or Caffeine types directly.

  New interfaces in org.apache.jackrabbit.oak.cache:

  - OakCache<K,V> — base interface: getIfPresent, get(K, Function) (Caffeine-aligned, unchecked, @Nullable), put, invalidate, invalidateAll, estimatedSize, asMap, getAllPresent, cleanUp, stats()
  - OakLoadingCache<K,V> extends OakCache — get(K) returns @NotNull, throws CompletionException on loader failure; refresh(K)
  - OakCacheLoader<K,V> — functional interface: V load(K) throws Exception
  - OakWeigher<K,V> — functional interface: int weigh(K, V)
  - OakRemovalCause — enum: EXPLICIT, REPLACED, SIZE, EXPIRED, COLLECTED
  - OakRemovalListener<K,V> — functional interface: void onRemoval(K, V, OakRemovalCause)
  - OakCacheStats — immutable value object: hitCount, missCount, loadSuccessCount, loadFailureCount, totalLoadTime, evictionCount; methods minus(), hitRate(), missRate(), requestCount()

  No changes to AbstractCacheStats, CacheStats, or CacheLIRS. All existing call sites continue to compile unchanged.

  Acceptance criteria:
  - oak-core-spi compiles with no new Caffeine or Guava types in the public API
  - All existing oak-core-spi tests pass
  - No consumer module is changed



--
This message was sent by Atlassian Jira
(v8.20.10#820010)