CaffeineExpiringCache

All Implemented Interfaces:
```
public class CaffeineExpiringCache<K extends Object, V extends Object>

                    
```
A Caffeine-backed alternative to ai.platon.pulsar.common.concurrent.ConcurrentExpiringLRUCache that exposes the same putDatum / getDatum / remove / clear / size API for drop-in compatibility.
Entries are evicted via Caffeine's Window TinyLFU policy when the cache exceeds capacity, and expire after ttl regardless of access.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public final class`	`CaffeineExpiringCache.Entry`	Lightweight entry wrapper so that remove can return the removed value via `.datum`, matching the ConcurrentExpiringLRUCache contract.
`public class`	`CaffeineExpiringCache.Companion`

Field Summary

Fields
Modifier and Type	Field	Description
`public final static Long`	`DEFAULT_CAPACITY`
`private final Long`	`size`
`public final static CaffeineExpiringCache.Companion`	`Companion`

Constructor Summary

Constructors
Constructor	Description
`CaffeineExpiringCache(Duration ttl, Long capacity)`

Enum Constant Summary

Enum Constants
Enum Constant	Description

Method Summary

Modifier and Type	Method	Description
`final Long`	`getSize()`
`final Unit`	`putDatum(K key, V value)`	Cache an item.
`final V`	`getDatum(K key)`	Retrieve a non-expired item (Caffeine handles time-based expiry automatically).
`final V`	`getDatum(K key, Duration expires, Instant now)`	Retrieve an item with an additional caller-specified expiry window.
`final CaffeineExpiringCache.Entry<V>`	`remove(K key)`	Remove and return the cached entry.
`final Unit`	`clear()`	Remove all entries.
`final Cache<K, CaffeineExpiringCache.Entry<V>>`	`asCache()`	Underlying Caffeine cache for direct access when needed.
`final CacheStats`	`stats()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - CaffeineExpiringCache
```
CaffeineExpiringCache(Duration ttl, Long capacity)
```
- Method Detail
  - getSize
```
 final Long getSize()
```
  - putDatum
```
 final Unit putDatum(K key, V value)
```
    Cache an item.
  - getDatum
```
 final V getDatum(K key)
```
    Retrieve a non-expired item (Caffeine handles time-based expiry automatically).
  - getDatum
```
 final V getDatum(K key, Duration expires, Instant now)
```
    Retrieve an item with an additional caller-specified expiry window.
    Caffeine already expires entries based on the cache-level TTL, but callers may pass a tighter expires duration + now to reject entries that are technically in the cache but older than the caller's threshold.
    NOTE: The caller is responsible for checking the returned value's own timestamp (e.g. ai.platon.pulsar.persist.WebPage.prevFetchTime) via options.isExpired().
  - remove
```
 final CaffeineExpiringCache.Entry<V> remove(K key)
```
    Remove and return the cached entry.
    
    Returns:
    
    the removed Entry (with its Entry.datum), or null if the key was not present.
  - clear
```
 final Unit clear()
```
    Remove all entries.
  - asCache
```
 final Cache<K, CaffeineExpiringCache.Entry<V>> asCache()
```
    Underlying Caffeine cache for direct access when needed.
  - stats
```
 final CacheStats stats()
```