MemorySimulationRunCache

A memory-based cache to hold simulation runs. A simplified cache to avoid including more advanced caches in the dependency tree. This cache holds simulation runs in a map based on (RequestData, SimulationRun) pairs. The cache capacity is constrained to the specified capacity. The user can supply an eviction rule that will identify a simulation run to evict when the capacity is reached. If no eviction rule is supplied, then by default, the algorithm removes the oldest simulation run.

Parameters

capacity

the maximum permitted size of the cache

map

the map to use as the cache. The map must be mutable.

Throws

if the capacity is less than 2.

Constructors

Link copied to clipboard
constructor(capacity: Int = defaultCacheSize)

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard
open override val capacity: Int
Link copied to clipboard
Link copied to clipboard

A rule to govern which solution should be evicted when the cache capacity is met.

Link copied to clipboard
open override val keys: Set<RequestData>
Link copied to clipboard
open override val size: Int
Link copied to clipboard
open override val values: Collection<SimulationRun>

Functions

Link copied to clipboard
open override fun containsKey(key: RequestData): Boolean
Link copied to clipboard
open override fun containsValue(value: SimulationRun): Boolean
Link copied to clipboard

By default, the eviction candidate will be the oldest request in the cache.

Link copied to clipboard
open operator override fun get(key: RequestData): SimulationRun?
Link copied to clipboard
open override fun isEmpty(): Boolean
Link copied to clipboard
open override fun put(requestData: RequestData, simulationRun: SimulationRun): SimulationRun?

Places the simulation run into the cache. It is important that implementors ensure that the input names and response names associated with the request are consistent with the input names and response names of the simulation run.

Link copied to clipboard
open override fun remove(requestData: RequestData): SimulationRun?

Looks up and removes the simulation run associated with the supplied request. Null is returned if there is no associated simulation run. It is important that implementors handle the reduced size relative to the cache.

Link copied to clipboard
open override fun simulationRuns(): List<SimulationRun>

Retrieves the simulation runs in the cache as a list of simulation runs

Link copied to clipboard
open override fun toJson(): String
Link copied to clipboard
fun validatePair(requestData: RequestData, simulationRun: SimulationRun): Boolean

Validates whether a given RequestData instance is compatible with a specified SimulationRun instance.