PdfHandleCacheStatsDto

Statistics about the in-memory open-document handle cache.

Backed by PdfHandleCache in the service layer. Avoids re-opening the underlying PDF file via PDFium on every page request.

capacityinteger<int64>required

Maximum number of handles the cache will retain.

Possible values: >= 0

Example: 256

currentSizeinteger<int64>required

Number of handles currently cached.

Possible values: >= 0

Example: 12

enabledbooleanrequired

Whether the handle cache is enabled.

Example: true

entries object[]required

Per-entry detail for the admin UI.

Array [

ageSecondsinteger<int64>required

Seconds since the handle was opened.

Possible values: >= 0

Example: 312

bookIdstring<uuid>required

Book ID for the cached document.

Example: 550e8400-e29b-41d4-a716-446655440000

filePathstringrequired

File path of the opened PDF.

Example: /library/books/manual.pdf

idleSecondsinteger<int64>required

Seconds since the last render against this handle.

Possible values: >= 0

Example: 14

renderCountinteger<int64>required

Number of renders served from this handle.

Possible values: >= 0

Example: 27

]

evictionsinteger<int64>required

Cumulative evictions (capacity + manual).

Possible values: >= 0

Example: 5

hitsinteger<int64>required

Cumulative cache hits (handle reused without re-opening).

Possible values: >= 0

Example: 4321

idleEvictionsinteger<int64>required

Cumulative idle-TTL evictions performed by the sweeper.

Possible values: >= 0

Example: 3

idleTtlSecondsinteger<int64>required

Idle TTL in seconds before a handle is evicted by the background sweeper.

Possible values: >= 0

Example: 900

missesinteger<int64>required

Cumulative cache misses (no entry on lookup).

Possible values: >= 0

Example: 87

opensinteger<int64>required

Cumulative PDFium opens performed by the cache.

Possible values: >= 0

Example: 87

PdfHandleCacheStatsDto

{
  "capacity": 256,
  "currentSize": 12,
  "enabled": true,
  "entries": [
    {
      "ageSeconds": 312,
      "bookId": "550e8400-e29b-41d4-a716-446655440000",
      "filePath": "/library/books/manual.pdf",
      "idleSeconds": 14,
      "renderCount": 27
    }
  ],
  "evictions": 5,
  "hits": 4321,
  "idleEvictions": 3,
  "idleTtlSeconds": 900,
  "misses": 87,
  "opens": 87
}