Flag for printing warnings when using deprecated APIs.

Author: kimeta

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/hosted/RuntimeForeignAccess.java

@@ -47,12 +47,15 @@
 import org.graalvm.nativeimage.Platform;
 import org.graalvm.nativeimage.Platforms;
 import org.graalvm.nativeimage.dynamicaccess.ForeignAccess;
+import org.graalvm.nativeimage.impl.APIDeprecationSupport;
 import org.graalvm.nativeimage.dynamicaccess.AccessCondition;
 import org.graalvm.nativeimage.impl.RuntimeForeignAccessSupport;
 
 @Platforms(Platform.HOSTED_ONLY.class)
 public final class RuntimeForeignAccess {
 
+    private static final APIDeprecationSupport deprecationFlag = ImageSingletons.lookup(APIDeprecationSupport.class);
+
     /**
      * Registers the provided function descriptor and options pair at image build time for downcalls
      * into foreign code. Required to get a downcall method handle using
@@ -71,6 +74,7 @@ public final class RuntimeForeignAccess {
      * @since 23.1
      */
     public static void registerForDowncall(Object desc, Object... options) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeForeignAccessSupport.class).registerForDowncall(AccessCondition.unconditional(), desc, options);
     }
 
@@ -91,6 +95,7 @@ public static void registerForDowncall(Object desc, Object... options) {
      * @since 24.1
      */
     public static void registerForUpcall(Object desc, Object... options) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeForeignAccessSupport.class).registerForUpcall(AccessCondition.unconditional(), desc, options);
     }
 
@@ -121,6 +126,7 @@ public static void registerForUpcall(Object desc, Object... options) {
      * @since 24.2
      */
     public static void registerForDirectUpcall(MethodHandle target, Object desc, Object... options) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeForeignAccessSupport.class).registerForDirectUpcall(AccessCondition.unconditional(), target, desc, options);
     }
 

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/hosted/RuntimeJNIAccess.java

@@ -47,6 +47,7 @@
 import org.graalvm.nativeimage.Platform;
 import org.graalvm.nativeimage.Platforms;
 import org.graalvm.nativeimage.dynamicaccess.JNIAccess;
+import org.graalvm.nativeimage.impl.APIDeprecationSupport;
 import org.graalvm.nativeimage.dynamicaccess.AccessCondition;
 import org.graalvm.nativeimage.impl.RuntimeJNIAccessSupport;
 
@@ -59,6 +60,8 @@
 @Platforms(Platform.HOSTED_ONLY.class)
 public final class RuntimeJNIAccess {
 
+    private static final APIDeprecationSupport deprecationFlag = ImageSingletons.lookup(APIDeprecationSupport.class);
+
     /**
      * Makes the provided classes available for JNI access at run time. Needed when native code
      * looks up Java classes via <a href=
@@ -69,6 +72,7 @@ public final class RuntimeJNIAccess {
      * @since 22.3
      */
     public static void register(Class<?>... classes) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeJNIAccessSupport.class).register(AccessCondition.unconditional(), classes);
     }
 
@@ -84,6 +88,7 @@ public static void register(Class<?>... classes) {
      * @since 22.3
      */
     public static void register(Executable... methods) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeJNIAccessSupport.class).register(AccessCondition.unconditional(), false, methods);
     }
 
@@ -99,6 +104,7 @@ public static void register(Executable... methods) {
      * @since 22.3
      */
     public static void register(Field... fields) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeJNIAccessSupport.class).register(AccessCondition.unconditional(), false, fields);
     }
 

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/hosted/RuntimeProxyCreation.java

@@ -45,6 +45,7 @@
 import org.graalvm.nativeimage.Platforms;
 import org.graalvm.nativeimage.dynamicaccess.ReflectiveAccess;
 import org.graalvm.nativeimage.dynamicaccess.AccessCondition;
+import org.graalvm.nativeimage.impl.APIDeprecationSupport;
 import org.graalvm.nativeimage.impl.RuntimeProxyCreationSupport;
 
 /**
@@ -55,6 +56,8 @@
 @Platforms(Platform.HOSTED_ONLY.class)
 public final class RuntimeProxyCreation {
 
+    private static final APIDeprecationSupport deprecationFlag = ImageSingletons.lookup(APIDeprecationSupport.class);
+
     /**
      * Enables registering specifications of {@link java.lang.reflect.Proxy} classes during the
      * image build so that matching proxy objects can be created at runtime. The proxy class is
@@ -65,6 +68,7 @@ public final class RuntimeProxyCreation {
      * @since 22.3
      */
     public static void register(Class<?>... interfaces) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeProxyCreationSupport.class).addProxyClass(AccessCondition.unconditional(), interfaces);
     }
 

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/hosted/RuntimeReflection.java

@@ -50,6 +50,7 @@
 import org.graalvm.nativeimage.Platforms;
 import org.graalvm.nativeimage.dynamicaccess.ReflectiveAccess;
 import org.graalvm.nativeimage.dynamicaccess.AccessCondition;
+import org.graalvm.nativeimage.impl.APIDeprecationSupport;
 import org.graalvm.nativeimage.impl.RuntimeReflectionSupport;
 
 //Checkstyle: allow reflection
@@ -63,6 +64,8 @@
 @Platforms(Platform.HOSTED_ONLY.class)
 public final class RuntimeReflection {
 
+    private static final APIDeprecationSupport deprecationFlag = ImageSingletons.lookup(APIDeprecationSupport.class);
+
     /**
      * Makes the provided classes available for reflection at run time. A call to
      * {@link Class#forName} for the names of the classes will return the classes at run time.
@@ -72,6 +75,7 @@ public final class RuntimeReflection {
      * @since 19.0
      */
     public static void register(Class<?>... classes) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).register(AccessCondition.unconditional(), classes);
     }
 
@@ -85,6 +89,7 @@ public static void register(Class<?>... classes) {
      * @since 23.0
      */
     public static void registerClassLookup(String className) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerClassLookup(AccessCondition.unconditional(), className);
     }
 
@@ -98,6 +103,7 @@ public static void registerClassLookup(String className) {
      * @since 19.0
      */
     public static void register(Executable... methods) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).register(AccessCondition.unconditional(), false, methods);
     }
 
@@ -112,6 +118,7 @@ public static void register(Executable... methods) {
      * @since 21.3
      */
     public static void registerAsQueried(Executable... methods) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).register(AccessCondition.unconditional(), true, methods);
     }
 
@@ -127,6 +134,7 @@ public static void registerAsQueried(Executable... methods) {
      * @since 23.0
      */
     public static void registerMethodLookup(Class<?> declaringClass, String methodName, Class<?>... parameterTypes) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerMethodLookup(AccessCondition.unconditional(), declaringClass, methodName, parameterTypes);
     }
 
@@ -143,6 +151,7 @@ public static void registerMethodLookup(Class<?> declaringClass, String methodNa
      * @since 23.0
      */
     public static void registerConstructorLookup(Class<?> declaringClass, Class<?>... parameterTypes) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerConstructorLookup(AccessCondition.unconditional(), declaringClass, parameterTypes);
     }
 
@@ -156,6 +165,7 @@ public static void registerConstructorLookup(Class<?> declaringClass, Class<?>..
      * @since 19.0
      */
     public static void register(Field... fields) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).register(AccessCondition.unconditional(), false, fields);
     }
 
@@ -170,6 +180,7 @@ public static void register(Field... fields) {
      * @since 19.0
      */
     public static void registerFieldLookup(Class<?> declaringClass, String fieldName) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerFieldLookup(AccessCondition.unconditional(), declaringClass, fieldName);
     }
 
@@ -181,6 +192,7 @@ public static void registerFieldLookup(Class<?> declaringClass, String fieldName
      * @since 23.0
      */
     public static void registerAllClasses(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllClassesQuery(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -192,6 +204,7 @@ public static void registerAllClasses(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllDeclaredClasses(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllDeclaredClassesQuery(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -204,6 +217,7 @@ public static void registerAllDeclaredClasses(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllMethods(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllMethodsQuery(AccessCondition.unconditional(), true, declaringClass);
     }
 
@@ -216,6 +230,7 @@ public static void registerAllMethods(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllDeclaredMethods(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllDeclaredMethodsQuery(AccessCondition.unconditional(), true, declaringClass);
     }
 
@@ -228,6 +243,7 @@ public static void registerAllDeclaredMethods(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllConstructors(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllConstructorsQuery(AccessCondition.unconditional(), true, declaringClass);
     }
 
@@ -240,6 +256,7 @@ public static void registerAllConstructors(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllDeclaredConstructors(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllDeclaredConstructorsQuery(AccessCondition.unconditional(), true, declaringClass);
     }
 
@@ -252,6 +269,7 @@ public static void registerAllDeclaredConstructors(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllFields(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllFields(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -264,6 +282,7 @@ public static void registerAllFields(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllDeclaredFields(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllDeclaredFields(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -275,6 +294,7 @@ public static void registerAllDeclaredFields(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllNestMembers(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllNestMembersQuery(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -286,6 +306,7 @@ public static void registerAllNestMembers(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllPermittedSubclasses(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllPermittedSubclassesQuery(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -297,6 +318,7 @@ public static void registerAllPermittedSubclasses(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllRecordComponents(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllRecordComponentsQuery(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -308,6 +330,7 @@ public static void registerAllRecordComponents(Class<?> declaringClass) {
      * @since 23.0
      */
     public static void registerAllSigners(Class<?> declaringClass) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeReflectionSupport.class).registerAllSignersQuery(AccessCondition.unconditional(), declaringClass);
     }
 
@@ -343,6 +366,7 @@ public static void register(boolean finalIsWritable, boolean allowUnsafeAccess,
      * @since 19.0
      */
     public static void registerForReflectiveInstantiation(Class<?>... classes) {
+        deprecationFlag.printDeprecationWarning();
         for (Class<?> clazz : classes) {
             if (clazz.isArray() || clazz.isInterface() || Modifier.isAbstract(clazz.getModifiers())) {
                 throw new IllegalArgumentException("Class " + clazz.getTypeName() + " cannot be instantiated reflectively. It must be a non-abstract instance type.");

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/hosted/RuntimeResourceAccess.java

@@ -48,6 +48,7 @@
 import org.graalvm.nativeimage.Platform;
 import org.graalvm.nativeimage.Platforms;
 import org.graalvm.nativeimage.dynamicaccess.ResourceAccess;
+import org.graalvm.nativeimage.impl.APIDeprecationSupport;
 import org.graalvm.nativeimage.dynamicaccess.AccessCondition;
 import org.graalvm.nativeimage.impl.RuntimeResourceSupport;
 
@@ -58,6 +59,8 @@
 @Platforms(Platform.HOSTED_ONLY.class)
 public final class RuntimeResourceAccess {
 
+    private static final APIDeprecationSupport deprecationFlag = ImageSingletons.lookup(APIDeprecationSupport.class);
+
     /**
      * Make Java resource {@code resourcePath} from {@code module} available at run time. If the
      * given {@code module} is unnamed, the resource is looked up on the classpath instead.
@@ -67,6 +70,7 @@ public final class RuntimeResourceAccess {
      * @since 22.3
      */
     public static void addResource(Module module, String resourcePath) {
+        deprecationFlag.printDeprecationWarning();
         Objects.requireNonNull(module);
         Objects.requireNonNull(resourcePath);
         ImageSingletons.lookup(RuntimeResourceSupport.class).addResource(module, resourcePath, "Manually added via RuntimeResourceAccess");
@@ -83,6 +87,7 @@ public static void addResource(Module module, String resourcePath) {
      * @since 22.3
      */
     public static void addResource(Module module, String resourcePath, byte[] resourceContent) {
+        deprecationFlag.printDeprecationWarning();
         Objects.requireNonNull(module);
         Objects.requireNonNull(resourcePath);
         Objects.requireNonNull(resourceContent);
@@ -100,6 +105,7 @@ public static void addResource(Module module, String resourcePath, byte[] resour
      * @since 22.3
      */
     public static void addResourceBundle(Module module, String baseBundleName, Locale[] locales) {
+        deprecationFlag.printDeprecationWarning();
         Objects.requireNonNull(locales);
         RuntimeResourceSupport.singleton().addResourceBundles(AccessCondition.unconditional(),
                         withModuleName(module, baseBundleName), Arrays.asList(locales));
@@ -115,6 +121,7 @@ public static void addResourceBundle(Module module, String baseBundleName, Local
      * @since 22.3
      */
     public static void addResourceBundle(Module module, String bundleName) {
+        deprecationFlag.printDeprecationWarning();
         RuntimeResourceSupport.singleton().addResourceBundles(AccessCondition.unconditional(),
                         withModuleName(module, bundleName));
     }

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/hosted/RuntimeSerialization.java

@@ -40,9 +40,11 @@
  */
 package org.graalvm.nativeimage.hosted;
 
+import org.graalvm.nativeimage.ImageSingletons;
 import org.graalvm.nativeimage.Platform;
 import org.graalvm.nativeimage.Platforms;
 import org.graalvm.nativeimage.dynamicaccess.ReflectiveAccess;
+import org.graalvm.nativeimage.impl.APIDeprecationSupport;
 import org.graalvm.nativeimage.dynamicaccess.AccessCondition;
 import org.graalvm.nativeimage.impl.RuntimeSerializationSupport;
 
@@ -55,6 +57,8 @@
 @Platforms(Platform.HOSTED_ONLY.class)
 public final class RuntimeSerialization {
 
+    private static final APIDeprecationSupport deprecationFlag = ImageSingletons.lookup(APIDeprecationSupport.class);
+
     /**
      * Register the specified serialization target class itself and all associated classes.
      * <p>
@@ -75,6 +79,7 @@ public final class RuntimeSerialization {
      * @since 21.3
      */
     public static void registerIncludingAssociatedClasses(Class<?> clazz) {
+        deprecationFlag.printDeprecationWarning();
         RuntimeSerializationSupport.singleton().registerIncludingAssociatedClasses(AccessCondition.unconditional(), clazz);
     }
 
@@ -86,6 +91,7 @@ public static void registerIncludingAssociatedClasses(Class<?> clazz) {
      * @since 21.3
      */
     public static void register(Class<?>... classes) {
+        deprecationFlag.printDeprecationWarning();
         for (Class<?> clazz : classes) {
             RuntimeSerializationSupport.singleton().register(AccessCondition.unconditional(), clazz);
         }
@@ -121,6 +127,7 @@ public static void registerWithTargetConstructorClass(Class<?> clazz, Class<?> c
      * @since 22.3
      */
     public static void registerLambdaCapturingClass(Class<?> lambdaCapturingClass) {
+        deprecationFlag.printDeprecationWarning();
         RuntimeSerializationSupport.singleton().registerLambdaCapturingClass(AccessCondition.unconditional(), lambdaCapturingClass);
     }
 
@@ -134,6 +141,7 @@ public static void registerLambdaCapturingClass(Class<?> lambdaCapturingClass) {
      * @since 22.3
      */
     public static void registerProxyClass(Class<?>... implementedInterfaces) {
+        deprecationFlag.printDeprecationWarning();
         RuntimeSerializationSupport.singleton().registerProxyClass(AccessCondition.unconditional(), implementedInterfaces);
     }