← Index · ← File index · ← Prev · Next → · 📄 source

#1310: `HistoryLoadContext.kt`

projectforge-business/src/main/kotlin/org/projectforge/framework/persistence/history/HistoryLoadContext.kt Service/Context Class, projectforge-business/.../persistence/history/HistoryLoadContext.kt 170 lines · 107 code · 29 comments · 34 blank

Thread-safe mutable context used during history entry loading and conversion. Stores raw history entries, loaded entities, and entry-attribute mappings; provides iteration state (current entry/attr) for converters and display formatters.

Architecture & Role

HistoryLoadContext serves as the central state-holder when history data is loaded from the database and transformed into human-/JSON-readable DisplayHistoryEntry objects. It is instantiated per load operation (not a singleton) and passed through the chain of history converters.

Key Inner Classes

Class	Purpose
`HistoryEntryMap`	Pairs a raw `HistoryEntryDO` with its display counterpart and a mutable extension map for custom data.
`HistoryEntryAttrMap`	Pairs a raw `HistoryEntryAttrDO` with its display counterpart and a mutable extension map.

State Management

The context maintains:

historyEntries — merged list of HistoryEntryDO, deduplicated by id
loadedEntities — entities (BaseDO) already fetched, used to avoid re-fetches
historyEntryAttrMap — per-attribute property maps keyed by attr ID (Long → HistoryEntryAttrMap)
Current iteration state: currentHistoryEntry, currentHistoryEntryAttr, currentDisplayHistoryEntry, currentDisplayHistoryEntryAttr
References to UserGroupCache, HistoryValueService, and the owning BaseDao

Delegation Methods

Delegates value resolution to historyValueService: getObjectValue() resolves string-encoded values to typed objects; getClass() resolves class names to Class<?>. User resolution delegates to UserGroupCache via getUser(id).

Git History