Tidy up Lazy.java

- Add missing Nullable annotation.
- Document Loom behaviour for synchronization.
- Mark class as final

Signed-off-by: ascopes <[email protected]>

Author: ascopes

java-compiler-testing/src/main/java/io/github/ascopes/jct/utils/Lazy.java

@@ -19,6 +19,7 @@
 import java.util.function.Supplier;
 import org.apiguardian.api.API;
 import org.apiguardian.api.API.Status;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Helper type that wraps an initializer and invokes it lazily as required.
@@ -32,16 +33,19 @@
  * <p>This descriptor is thread-safe. No guarantees are made about the thread-safety of the
  * internally stored data, nor the initializer supplier.
  *
+ * <p>This descriptor currently does not support virtual threads. Any synchronization will
+ * occur on the physical thread level.
+ *
  * @param <T> the type of lazy value to return when accessed.
  * @author Ashley Scopes
  * @since 0.0.1
  */
 @API(since = "0.0.1", status = Status.INTERNAL)
-public class Lazy<T> {
+public final class Lazy<T> {
 
   private final Supplier<T> initializer;
   private final Object lock;
-  private volatile T data;
+  private volatile @Nullable T data;
 
   /**
    * Initialize the object.