stash_api library
Standard caching API for Dart. Defines a common mechanism to create, access, update, and remove information from caches.
Classes
- AccessedExpiryPolicy
- An ExpiryPolicy that defines the expiry Duration of a Cache Entry based on the last time it was accessed. Accessed does not include a cache update.
- BytesReader
- Defines the base class supporting reads from a stream of bytes
- BytesWriter
- Defines the base class supporting writes to a stream of bytes
-
Cache<
T> - The cache definition and the hub for the creation of caches
- CacheEntry
- The wrapper around the object that is added to the cache
-
CacheEntryBuilder<
T> - The CacheEntry builder
-
CacheEntryCreatedEvent<
T> - The entry created event
-
CacheEntryEvictedEvent<
T> - A cache entry evicted event
-
CacheEntryExpiredEvent<
T> - A cache entry expired event
-
CacheEntryRemovedEvent<
T> - A cache entry removed event
-
CacheEntryUpdatedEvent<
T> - A Cache entry updated event
-
CacheEvent<
T> - A Cache event
- CacheInfo
- Base class with all the info fields for the Cache
- CacheManager
- CacheStats
-
The
Statsdefinition for a cache - CacheStore
- CreatedExpiryPolicy
- An ExpiryPolicy that defines the expiry Duration of a Cache Entry based on when it was created. An update does not reset the expiry time.
- DefaultCacheManager
- DefaultVaultManager
-
Entry<
T extends Info> -
EntryBuilder<
T, I extends Info, E extends Entry< I> > - The Entry builder
- EternalExpiryPolicy
- An eternal ExpiryPolicy specifies that Cache Entries won't expire. This however doesn't mean they won't be evicted if an underlying implementation needs to free-up resources where by it may choose to evict entries that are not due to expire.
- EvictionPolicy
- Defines the eviction policy contract that every cache eviction algorithm should implement
- ExpiryPolicy
- Defines functions to determine when cache entries will expire based on creation, access and modification operations.
- FifoEvictionPolicy
- Using this algorithm the cache behaves in the same way as a FIFO queue. The cache evicts the sampled entries in the order they were added, without any regard to how often or how many times they were accessed before. This algorithm uses CacheInfo.creationTime to keep track of when a entry was created.
- FiloEvictionPolicy
- This algorithm the cache behaves in the same way as a stack and exact opposite way as a FIFO queue. The cache evicts the entry added most recently first without any regard to how often or how many times it was accessed before. This algorithm uses CacheInfo.creationTime to keep track of when a entry was created.
- FullSampler
- A sampler that doesn't perform any sampling
-
GenericCache<
T> - Generic implementation of the Cache interface
-
GenericVault<
T> - Generic implementation of the Vault interface
- HyperbolicEvictionPolicy
- Discards based on how frequently the entries are used divided by their age.
- Info
- Base class with all the info fields
- KeySampler
- Defines a strategy to sample elements from a collection
- LfuEvictionPolicy
- Counts how often an item is needed. Those that are used least often are discarded first. This works very similar to LRU except that instead of storing the value of how recently a block was accessed, we store the value of how many times it was accessed. So of course while running an access sequence we will replace a entry which was used least number of times from our cache. E.g., if A was used (accessed) 5 times and B was used 3 times and others C and D were used 10 times each, we will replace B. This algorithm uses the CacheInfo.hitCount to keep track of how many times a entry was uses.
- LruEvictionPolicy
- Discards the least recently used items first. This algorithm uses the CacheInfo.accessTime to keep track of what was used when.
- MfuEvictionPolicy
- Counts how often an item is needed. Those that are used most often are discarded first. This works very similar to MRU except that instead of storing the value of how recently a block was accessed, we store the value of how many times it was accessed. So of course while running an access sequence we will replace a entry which was used most number of times from our cache. E.g., if A was used (accessed) 5 times and B was used 3 times and C was used 10 times, we will replace C. This algorithm uses the CacheInfo.hitCount to keep track of how many times a entry was uses.
- ModifiedExpiryPolicy
- An ExpiryPolicy that defines the expiry Duration of a Cache Entry based on the last time it was updated. Updating includes created and changing (updating) an entry.
- MruEvictionPolicy
- Discards, in contrast to LRU, the most recently used items first. This algorithm uses the CacheInfo.accessTime to keep track of what was used when.
-
PersistenceStore<
I extends Info, E extends Entry< I> > - A definition of a stores that persists data
-
Stash<
T> - The stash definition
-
StashEvent<
T, E extends Enum, S extends Stash< T> > - A stash event base class.
-
Store<
I extends Info, E extends Entry< I> > - Store definition
- StoreCodec
- Defines the contract of a binary codec that should be used for the serialization / deserealization of a value
-
TieredCache<
T> - Tiered implementation of the Cache interface allowing the assignement of a primary and secondary caches. It was designed to be used with a primary Cache bound to a fast store and a secondary cache bound to a persistent store implementation
- TouchedExpiryPolicy
- An ExpiryPolicy that defines the expiry Duration of a Cache Entry based on when it was last touched. A touch includes creation, update or access.
-
Vault<
T> - The vault definition and the hub for the creation of Vaults
- VaultEntry
- The wrapper around the object that added to the vault
-
VaultEntryBuilder<
T> - The VaultEntry builder
-
VaultEntryCreatedEvent<
T> - The entry created event
-
VaultEntryRemovedEvent<
T> - A vault entry removed event
-
VaultEntryUpdatedEvent<
T> - A Vault entry updated event
-
VaultEvent<
T> - A Cache event
- VaultInfo
- Base class with all the info fields for the Vault
- VaultManager
- VaultStats
-
The
Statsdefinition for a vault - VaultStore
Enums
- CacheEventType
- The type of event received by the listener.
- EntryState
- The state of the Entry
- EventListenerMode
- ValueProcessor
- Value processor
- VaultEventType
- The type of event received by the listener.
Extensions
-
CacheExtension
on Store<
CacheInfo, CacheEntry> - Extension over Store allowing the creation of multiple caches from the same store
-
StashExtension
on Stash<
T> - Extension over Stash to add some helper methods
-
VaultExtension
on Store<
VaultInfo, VaultEntry> - Extension over Store allowing the creation of multiple vaults from the same store
Constants
- float32Size → const int
- Size of a float32 in bytes
- float64Size → const int
- Size of a float64 in bytes
- int16Size → const int
- Size of a int16 in bytes
- int32Size → const int
- Size of a int32 in bytes
- int64Size → const int
- Size of a int64 in bytes
- int8Size → const int
- Size of a int8 in bytes
- uint16Size → const int
- Size of a uint16 in bytes
- uint32Size → const int
- Size of a uint32 in bytes
- uint64Size → const int
- Size of a uint64 in bytes
- uint8Size → const int
- Size of a uint8 in bytes
Functions
-
newTieredCache<
T> (CacheManager? manager, Cache< T> primary, Cache<T> secondary, {String? name, bool? statsEnabled, CacheStats? stats}) → Cache<T> - Builds a new Tiered Cache
Typedefs
-
CacheEntryDelegate<
T> = CacheEntryBuilder< T> Function(CacheEntryBuilder<T> delegate) - Cache entry delegate
-
CacheLoader<
T> = Future< T> Function(String key) - Cache loader function
-
VaultEntryDelegate<
T> = VaultEntryBuilder< T> Function(VaultEntryBuilder<T> delegate) - Vault entry delegate