io.atlassian.util.concurrent

Class Lazy

java.lang.Object

io.atlassian.util.concurrent.Lazy

public final class Lazy
extends Object

Factory for creating lazily populated references.

Since:

2.1

Constructor Summary

Constructors

Constructor and Description
Lazy()

Method Summary

Modifier and Type	Method and Description
static <T> Supplier<T>	callable(Callable<T> factory) Memoizing reference that is lazily computed using the supplied factory.
static <T> ResettableLazyReference<T>	resettable(Supplier<T> factory) Returns a ResettableLazyReference which creates the value by applying the provided Supplier.
static <T> ResettableLazyReference<T>	resettableCallable(Callable<T> factory) Returns a ResettableLazyReference which creates the value by applying the provided Callable.
static <T> Supplier<T>	supplier(Supplier<T> factory) Memoizing reference that is lazily computed using the supplied factory.
static <T> Supplier<T>	timeToIdle(Supplier<T> factory, long time, TimeUnit unit) Memoizing reference that expires the specified amount of time after the last time it was accessed.
static <T> Supplier<T>	timeToLive(Supplier<T> factory, long time, TimeUnit unit) Memoizing reference that expires the specified amount of time after creation.

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

supplier

public static <T> Supplier<T> supplier(Supplier<T> factory)

Memoizing reference that is lazily computed using the supplied factory.

The factory is not held on to after it is used, enabling it to be garbage collected.

Type Parameters:

T - the type.

Parameters:

factory - for populating the initial value, called only once.

Returns:

a supplier

callable

public static <T> Supplier<T> callable(Callable<T> factory)

Memoizing reference that is lazily computed using the supplied factory.

The factory is not held on to after it is used, enabling it to be garbage collected.

Type Parameters:

T - the type.

Parameters:

factory - for populating the initial value, called only once.

Returns:

a supplier

Since:

4.1

timeToLive

public static <T> Supplier<T> timeToLive(Supplier<T> factory,
                                         long time,
                                         TimeUnit unit)

Memoizing reference that expires the specified amount of time after creation.

Type Parameters:

T - the type.

Parameters:

factory - for populating the initial value, called only once.

time - the amount

unit - the units the amount is in

Returns:

a supplier

timeToIdle

public static <T> Supplier<T> timeToIdle(Supplier<T> factory,
                                         long time,
                                         TimeUnit unit)

Memoizing reference that expires the specified amount of time after the last time it was accessed.

Type Parameters:

T - the type.

Parameters:

factory - for populating the initial value, called only once.

time - the amount

unit - the units the amount is in

Returns:

a supplier

resettable

public static <T> ResettableLazyReference<T> resettable(Supplier<T> factory)

Returns a ResettableLazyReference which creates the value by applying the provided Supplier.

Type Parameters:

T - the type of the contained element.

Parameters:

factory - that creates the value that will be held by the ResettableLazyReference.

Returns:

a ResettableLazyReference which creates the value by applying the provided Supplier.

Since:

3.0

resettableCallable

public static <T> ResettableLazyReference<T> resettableCallable(Callable<T> factory)

Returns a ResettableLazyReference which creates the value by applying the provided Callable.

Type Parameters:

T - the type of the contained element.

Parameters:

factory - that creates the value that will be held by the ResettableLazyReference.

Returns:

a ResettableLazyReference which creates the value by applying the provided Callable.

Since:

4.1