Class ConcurrentLazyFactory<T>

java.lang.Object
io.github.cowwoc.pouch10.core.ConcurrentLazyFactory<T>
Type Parameters:
T - the type of the value
All Implemented Interfaces:
Factory<T>, Reference<T>, Closeable, AutoCloseable
public abstract class ConcurrentLazyFactory<T> extends Object implements Factory<T>
A thread-safe factory that initializes a value on demand.

The implementation is thread-safe.

  • Constructor Details

    • ConcurrentLazyFactory

      protected ConcurrentLazyFactory()
      Creates a new instance.

  • Method Details

    • create

      public static <T> ConcurrentLazyFactory<T> create(Supplier<T> supplier, Consumer<T> disposer)
      Creates a new ConcurrentLazyFactory.
      Type Parameters:
      T - the type of value returned by the factory
      Parameters:
      supplier - supplies the factory value
      disposer - implements disposeValue(T)
      Returns:
      a new ConcurrentLazyFactory

    • create

      public static <T extends AutoCloseable> ConcurrentLazyFactory<T> create(Supplier<T> supplier)
      Creates a new ConcurrentLazyFactory that disposes its value by invoking close(). If close() throws a checked exception, it is wrapped in a RuntimeException or an exception that extends it.
      Type Parameters:
      T - the type of value returned by the factory
      Parameters:
      supplier - supplies the factory value
      Returns:
      a new ConcurrentLazyFactory

    • createValue

      protected abstract T createValue()
      Creates the value. This method is invoked the first time getValue() is invoked.
      Returns:
      the value

    • disposeValue

      protected abstract void disposeValue(T value)
      Disposes the value.

      This method is invoked the first time close() is invoked, and only if the value was already initialized. This method may not invoke any other method as the factory is already marked as closed.

      Parameters:
      value - the value to dispose

    • getValue

      public final T getValue()
      Returns the value. Subsequent invocations of this method return the same value.
      Specified by:
      getValue in interface Reference<T>
      Returns:
      an object of type <T>
      Throws:
      IllegalStateException - if the factory is closed

    • isInitialized

      public boolean isInitialized()
      Description copied from interface: Reference
      Indicates if the value was initialized.

      A value may get initialized immediately after this method returns false but once it returns true it will continue to do so indefinitely.

      Specified by:
      isInitialized in interface Reference<T>
      Returns:
      true if the value was initialized

    • close

      public final void close()
      Description copied from interface: Factory
      Disposes the Factory and the value. Subsequent invocations of this method have no effect. Invoking any other method after this one results in IllegalStateException being thrown.
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Specified by:
      close in interface Factory<T>

    • toString

      public String toString()
      Overrides:
      toString in class Object