ai.eloquent.util

Class Lazy<E>

java.lang.Object

ai.eloquent.util.Lazy<E>

public abstract class Lazy<E>
extends java.lang.Object

An instantiation of a lazy object.

Constructor Summary

Constructors

Constructor and Description
Lazy()

Method Summary

Modifier and Type	Method and Description
static <E> Lazy<E>	cache(java.util.function.Supplier<E> fn) Create a lazy value from the given provider, allowing the value stored in the lazy to be garbage collected if necessary.
protected abstract E	compute() Compute the value of this lazy.
static <E> Lazy<E>	from(E definedElement) Create a degenerate Lazy, which simply returns the given pre-computed value.
E	get() Get the value of this Lazy, computing it if necessary.
E	getIfDefined() Get the value of this Lazy if it's been initialized, or else return null.
abstract boolean	isCache() Specify whether this lazy should garbage collect its value if needed, or whether it should force it to be persistent.
boolean	isGarbageCollected() Check if this lazy has been garbage collected, if it is a cached value.
static <E> Lazy<E>	of(java.util.function.Supplier<E> fn) Create a lazy value from the given provider.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Lazy

public Lazy()

Method Detail

get

public E get()

Get the value of this Lazy, computing it if necessary.

compute

protected abstract E compute()

Compute the value of this lazy.

isCache

public abstract boolean isCache()

Specify whether this lazy should garbage collect its value if needed, or whether it should force it to be persistent.

getIfDefined

public E getIfDefined()

Get the value of this Lazy if it's been initialized, or else return null.

isGarbageCollected

public boolean isGarbageCollected()

Check if this lazy has been garbage collected, if it is a cached value. Useful for, e.g., clearing keys in a map when the values are already gone.

from

public static <E> Lazy<E> from(E definedElement)

Create a degenerate Lazy, which simply returns the given pre-computed value.

of

public static <E> Lazy<E> of(java.util.function.Supplier<E> fn)

Create a lazy value from the given provider. The provider is only called once on initialization.

cache

public static <E> Lazy<E> cache(java.util.function.Supplier<E> fn)

Create a lazy value from the given provider, allowing the value stored in the lazy to be garbage collected if necessary. The value is then re-created by when needed again.