Interface Lazy<T>
- Type Parameters:
- T-
- All Superinterfaces:
- Referencing<T>
- All Known Implementing Classes:
- Lazy.Default
public interface Lazy<T> extends Referencing<T>
Note that the shortened name has been chosen intentionally to optimize readability in class design.
Also note that a type like this is strongly required in order to implement lazy loading behavior in an application in an architecturally clean and proper way. I.e. the application's data model design has to define that a certain reference is meant to be capable of lazy-loading. If such a definition is not done, a loading logic is strictly required to always load the encountered reference, as it is defined by the "normal" way of how references work. Any "tricks" of whatever framework to "sneak in" lazy loading behavior where it hasn't actually been defined are nothing more than dirty hacks and mess up if not destroy the program's consistency of state (e.g. antipatterns like secretly replacing a well-defined collection instance with a framework-proprietary proxy instance of a "similar" collection implementation). In proper architectured sofware, if a reference does not define lazy loading capacity, it is not wanted to have that capacity on the business logical level by design in the first place. Any attempts of saying "but I want it anyway in a sneaky 'transparent' way" indicate ambivalent conflicting design errors and thus in the end poor design.
- 
Nested Class SummaryNested Classes Modifier and Type Interface Description static interfaceLazy.Checkstatic interfaceLazy.Checkerstatic interfaceLazy.ClearingEvaluatorstatic classLazy.Default<T>
- 
Method SummaryModifier and Type Method Description static Lazy.CheckerChecker()static Lazy.CheckerChecker(double memoryQuota)static Lazy.CheckerChecker(long millisecondTimeout)static Lazy.CheckerChecker(long millisecondTimeout, double memoryQuota)static Lazy.CheckerChecker(long millisecondTimeout, double memoryQuota, Lazy.Check customCheck, LazyReferenceManager.CycleEvaluator cycleEvaluator)static Lazy.CheckerChecker(Lazy.Check customCheck)static Lazy.CheckerCheckerMemory(double memoryQuota)static Lazy.CheckerCheckerTimeout(long millisecondTimeout)Tclear()booleanclear(Lazy.ClearingEvaluator clearingEvaluator)static voidclear(Lazy<?> reference)Tget()Returns the referenced object, loading it if required.static <T> Tget(Lazy<T> reference)booleanisLoaded()static booleanisLoaded(Lazy<?> reference)booleanisStored()static booleanisStored(Lazy<?> reference)longlastTouched()Returns the timestamp (corresponding toSystem.currentTimeMillis()) when this instance has last been "touched", meaning having its reference modified or queried.static <T> Lazy<T>New(long objectId)static <T> Lazy<T>New(long objectId, ObjectSwizzling loader)static <T> Lazy<T>New(T subject, long objectId, ObjectSwizzling loader)Tpeek()Returns the local reference without loading the referenced object if it is not present.static <T> Tpeek(Lazy<T> reference)static <T> Lazy<T>Reference(T subject)static <T, L extends Lazy<T>>
 Lregister(L lazyReference)
- 
Method Details- 
getT get()Returns the referenced object, loading it if required.- Specified by:
- getin interface- Referencing<T>
- Returns:
- the lazily loaded referenced object.
 
- 
peekT peek()Returns the local reference without loading the referenced object if it is not present. The value returned bylastTouched()will not be changed by calling this method.- Returns:
- the currently present reference.
 
- 
clearT clear()
- 
isStoredboolean isStored()
- 
isLoadedboolean isLoaded()
- 
lastTouchedlong lastTouched()Returns the timestamp (corresponding toSystem.currentTimeMillis()) when this instance has last been "touched", meaning having its reference modified or queried.- Returns:
- the time this instance has last been significantly used.
 
- 
clear
- 
get
- 
peek
- 
clear
- 
isStored
- 
isLoaded
- 
Reference
- 
New
- 
New
- 
New
- 
register
- 
Checker
- 
Checker
- 
Checker
- 
Checker
- 
Checker
- 
Checkerstatic Lazy.Checker Checker(long millisecondTimeout, double memoryQuota, Lazy.Check customCheck, LazyReferenceManager.CycleEvaluator cycleEvaluator)
- 
CheckerTimeout
- 
CheckerMemory
 
-