TryCache (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- net.i2p.util.TryCache<T>

Type Parameters:
T - type of objects cached
Direct Known Subclasses:
ByteCache
```
public class TryCache<T>
extends Object
```
A thread-safe, lock-free-ish object cache that reuses objects to reduce allocation overhead. Designed to avoid object loss due to lock contention.

Nested Class Summary
Nested Classes
Modifier and Type Class and Description
static interface TryCache.ObjectFactory<T>
Factory interface for creating new objects in TryCache.

Nested Classes
Modifier and Type	Class and Description
`static interface`	`TryCache.ObjectFactory<T>` Factory interface for creating new objects in TryCache.

Constructor Summary
Constructors
Constructor and Description
TryCache(TryCache.ObjectFactory<T> factory, int capacity)
TryCache.

Constructors
Constructor and Description
`TryCache(TryCache.ObjectFactory<T> factory, int capacity)` TryCache.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`T`	`acquire()` Acquire an object from the cache or create a new one.
`void`	`clear()` Clear all cached items.
`long`	`getAcquireCount()` Return total acquire() count (hits + misses).
`int`	`getCapacity()` Return the current cache capacity.
`long`	`getDiscardCount()` Return the number of release() calls that were discarded because the cache was full.
`long`	`getLastUnderflowTime()` Get the timestamp of the last underflow.
`long`	`getMissCount()` Return the number of acquire() calls that found an empty cache (misses required allocating a new object).
`long`	`getReleaseCount()` Return total release() count (returned to cache).
`void`	`release(T item)` Try to return the item to the cache.
`void`	`resize(int newCapacity)` Resize the cache to a new capacity.
`void`	`shrink(int targetSize)` Shrink the cache to the target size, evicting excess items.
`int`	`size()` Get the current number of cached items.
`boolean`	`wasUnderfilled(long thresholdMillis)` Check if the cache has been underfilled longer than the threshold.

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

- Constructor Detail
  - TryCache
```
public TryCache(TryCache.ObjectFactory<T> factory,
                int capacity)
```
    TryCache.
- Method Detail
  - acquire
```
public T acquire()
```
    Acquire an object from the cache or create a new one.
    Returns:
    a cached or newly created object
  - clear
```
public void clear()
```
    Clear all cached items.
  - getAcquireCount
```
public long getAcquireCount()
```
    Return total acquire() count (hits + misses).
    Returns:
    the acquire count
  - getCapacity
```
public int getCapacity()
```
    Return the current cache capacity.
    Returns:
    the maximum number of cached items
  - getDiscardCount
```
public long getDiscardCount()
```
    Return the number of release() calls that were discarded because the cache was full.
    Returns:
    the discard count
  - getLastUnderflowTime
```
public long getLastUnderflowTime()
```
    Get the timestamp of the last underflow.
    Returns:
    the timestamp of the last underflow
  - getMissCount
```
public long getMissCount()
```
    Return the number of acquire() calls that found an empty cache (misses required allocating a new object).
    Returns:
    the miss count
  - getReleaseCount
```
public long getReleaseCount()
```
    Return total release() count (returned to cache).
    Returns:
    the release count
  - release
```
public void release(T item)
```
    Try to return the item to the cache. If the cache is full, the item is discarded.
    Parameters:
    item - the item
  - resize
```
public void resize(int newCapacity)
```
    Resize the cache to a new capacity. If shrinking, excess items are evicted. If growing, the cache simply allows more items to accumulate on future releases.
    Parameters:
    newCapacity - the new maximum number of entries
  - shrink
```
public void shrink(int targetSize)
```
    Shrink the cache to the target size, evicting excess items.
    Parameters:
    targetSize - the desired maximum number of items
  - size
```
public int size()
```
    Get the current number of cached items.
    Returns:
    the current number of cached items
  - wasUnderfilled
```
public boolean wasUnderfilled(long thresholdMillis)
```
    Check if the cache has been underfilled longer than the threshold.
    Parameters:
    thresholdMillis - the threshold in milliseconds
    Returns:
    true if the cache has been underfilled longer than the threshold

Class TryCache<T>

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

TryCache

Method Detail

acquire

clear

getAcquireCount

getCapacity

getDiscardCount

getLastUnderflowTime

getMissCount

getReleaseCount

release

resize

shrink

size

wasUnderfilled