-
Notifications
You must be signed in to change notification settings - Fork 53
Cleanup capabilities #81
Description
Some of the current defined capabilities are very hard to understand/useless and I would like to define some of them.
minTtl
This defines the minimum supported TTL which is clear but only a handful people knows that this also defines the general TTL support.
-
0 means TTL is supported
- 0 means TTL is not supported and all other TTL related capabilities can be ignored
There is no adapter having another value than 0 or 1 so this can be renamed to ttlSupported
with bool
.
-> minTtl
needs to be still available for BC reasons until the next major but can be marked deprecated.
staticTtl
This defines how the expiration time will be calculated which is not a meaningful description.
true
means the expiration time will be calculated on read using the last-modification-time of the item, the current time and the current TTL optionfalse
means the expiration time will be calculated using the current TTL and the current time. It will be stored together with the item
Thoughts for better names ?
expiredRead
There was the idea that it is possible to read an expired item by setting changing the TTL (like to 0 = infinitive) but this only works with staticTtl=true
to make it possible using an expired item in cases regeneration breaks (like on failed DB connection).
This is a useless capability because changing the TTL to something else automatically changes the expiration time of all stored items if staticTtl=true
which means in case for infinity the item is no longer expired. -> Bam the item is no longer expired but this capability is for reading expired items and the nature of staticTtl
already defines this behavior.
-> I would like to deprecate this capability and remove it in the next major version.