added Lazy object and methods

evpl · Mar 9, 2024 · 116777b · 116777b
1 parent b38da83
commit 116777b
Show file tree

Hide file tree

Showing 7 changed files with 1,177 additions and 12 deletions.
diff --git a/src/main/java/com/plugatar/jkscope/JKScope.java b/src/main/java/com/plugatar/jkscope/JKScope.java
@@ -104,6 +104,10 @@
  * <li>{@link #letWithResource(AutoCloseable, ThFunction)}</li>
  * <li>{@link #letWith(Object, Object, ThBiFunction)}</li>
  * <li>{@link #letWith(Object, Object, Object, ThTriFunction)}</li>
+ * <li>{@link #lazy(ThSupplier)}</li>
+ * <li>{@link #lazy(Object, ThSupplier)}</li>
+ * <li>{@link #lazy(Lazy.ThreadSafetyMode, ThSupplier)}</li>
+ * <li>{@link #lazyOfValue(Object)}</li>
  * </ul>
  * Some examples:
  * <pre>{@code
@@ -809,4 +813,60 @@ static <V1, V2, V3, R> R letWith(final V1 value1,
     blockArgNotNull(block);
     return block.asUnchecked().apply(value1, value2, value3);
   }
+
+  /**
+   * Returns a new {@link Lazy} instance that uses the specified initialization function and the
+   * {@link Lazy.ThreadSafetyMode#SYNCHRONIZED} thread-safety mode. The returned instance uses itself to synchronize
+   * on.
+   *
+   * @param initializer the value initializer
+   * @param <V>         the type of the value
+   * @return new {@link Lazy} instance
+   * @throws NullPointerException if {@code initializer} arg is null
+   */
+  static <V> Lazy<V> lazy(final ThSupplier<? extends V, ?> initializer) {
+    return Lazy.of(initializer);
+  }
+
+  /**
+   * Returns a new {@link Lazy} instance that uses the specified initialization function and the
+   * {@link Lazy.ThreadSafetyMode#SYNCHRONIZED} thread-safety mode. The returned instance uses the specified lock object
+   * to synchronize on.
+   *
+   * @param lock        the lock object
+   * @param initializer the value initializer
+   * @param <V>         the type of the value
+   * @return new {@link Lazy} instance
+   * @throws NullPointerException if {@code lock} or {@code initializer} arg is null
+   */
+  static <V> Lazy<V> lazy(final Object lock,
+                          final ThSupplier<? extends V, ?> initializer) {
+    return Lazy.of(lock, initializer);
+  }
+
+  /**
+   * Returns a new {@link Lazy} instance that uses the specified initialization function and thread-safety mode. For
+   * {@link Lazy.ThreadSafetyMode#SYNCHRONIZED} the returned instance uses itself to synchronize on.
+   *
+   * @param threadSafetyMode the thread safety mode
+   * @param initializer      the value initializer
+   * @param <V>              the type of the value
+   * @return new {@link Lazy} instance
+   * @throws NullPointerException if {@code threadSafetyMode} or {@code initializer} arg is null
+   */
+  static <V> Lazy<V> lazy(final Lazy.ThreadSafetyMode threadSafetyMode,
+                          final ThSupplier<? extends V, ?> initializer) {
+    return Lazy.of(threadSafetyMode, initializer);
+  }
+
+  /**
+   * Returns a new {@link Lazy} instance that is already initialized with the specified value.
+   *
+   * @param value the value
+   * @param <V>   the type of the value
+   * @return new {@link Lazy} instance
+   */
+  static <V> Lazy<V> lazyOfValue(final V value) {
+    return Lazy.ofValue(value);
+  }
 }