Package org.graalvm.nativeimage

Class ImageSingletons

java.lang.Object
org.graalvm.nativeimage.ImageSingletons
public final class ImageSingletons extends Object
A key-value store of singleton objects. The registry is populated during native image generation (no changes are allowed at run time); it is queried both during native image generation and at run time. The key is a class or interface, the value is an instance that extends that class.

When accessing the registry at run time, the key must be a compile time constant. The lookup(java.lang.Class<T>) is performed during native image generation, and the resulting value is put into the compiled code as a literal constant. Therefore, the actual map that stores the key-value data is not necessary at run time, and there is no lookup overhead at run time.

ImageSingletons avoids static fields: instead of filling a static field during native image generation and accessing it at run time, the value is put into the ImageSingletons. Usually, that happens in one of the early initialization methods of a Feature.

Since:
19.0

  • Method Details

    • add

      public static <T> void add(Class<T> key, T value)
      Add a singleton to the registry. The key must be unique, i.e., no value must have been registered with the given class before.
      Since:
      19.0

    • lookup

      public static <T> T lookup(Class<T> key)
      Lookup a singleton in the registry. The key must be a compile time constant, so that the call to this method can be replaced with the constant configuration objects.

      The key must have been added before, i.e., the result is guaranteed to be non- null.

      Since:
      19.0

    • contains

      public static boolean contains(Class<?> key)
      Checks if a singleton is in the registry. The key must be a compile time constant, so that the call to this method can be replaced with the constant true or false.

      The method returns false since 19.3.0 when not used in the context of a native image. As such it is safe to write: 

       if (ImageSingletons.contains(MyService.class)) {
     MyService myService = ImageSingletons.lookup(MyService.class);
     myService.useMyService();
 }
      and let such code run fine in the context of native image as well as outside of it.
      Since:
      19.0