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
@@ -63,14 +66,15 @@ public final class RuntimeForeignAccess {
      * performed to ensure that the arguments have the expected type. It will be deprecated in favor
      * of strongly typed variant as soon as possible.
      * <p>
-     * This API is deprecated; use {@link ForeignAccess} instead.
+     * This API is deprecated; use the {@link ForeignAccess} instead.
      *
      * @param desc A {@link java.lang.foreign.FunctionDescriptor} to register for downcalls.
      * @param options An array of {@link java.lang.foreign.Linker.Option} used for the downcalls.
      *
      * @since 23.1
      */
     public static void registerForDowncall(Object desc, Object... options) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeForeignAccessSupport.class).registerForDowncall(AccessCondition.unconditional(), desc, options);
     }
 
@@ -83,14 +87,15 @@ public static void registerForDowncall(Object desc, Object... options) {
      * performed to ensure that the arguments have the expected type. It will be deprecated in favor
      * of strongly typed variant as soon as possible.
      * <p>
-     * This API is deprecated; use {@link ForeignAccess} instead.
+     * This API is deprecated; use the {@link ForeignAccess} instead.
      *
      * @param desc A {@link java.lang.foreign.FunctionDescriptor} to register for upcalls.
      * @param options An array of {@link java.lang.foreign.Linker.Option} used for the upcalls.
      *
      * @since 24.1
      */
     public static void registerForUpcall(Object desc, Object... options) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeForeignAccessSupport.class).registerForUpcall(AccessCondition.unconditional(), desc, options);
     }
 
@@ -112,7 +117,7 @@ public static void registerForUpcall(Object desc, Object... options) {
      * of strongly typed variant as soon as possible.
      * </p>
      * <p>
-     * This API is deprecated; use {@link ForeignAccess} instead.
+     * This API is deprecated; use the {@link ForeignAccess} instead.
      *
      * @param target A direct method handle denoting a static method.
      * @param desc A {@link java.lang.foreign.FunctionDescriptor} to register for upcalls.
@@ -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,16 +60,19 @@
 @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=
      * "https://docs.oracle.com/en/java/javase/17/docs/specs/jni/functions.html#findclass">FindClass</a>.
      * <p>
-     * This API is deprecated; use {@link JNIAccess} instead.
+     * This API is deprecated; use the {@link JNIAccess} instead.
      *
      * @since 22.3
      */
     public static void register(Class<?>... classes) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeJNIAccessSupport.class).register(AccessCondition.unconditional(), classes);
     }
 
@@ -79,11 +83,12 @@ public static void register(Class<?>... classes) {
      * or <a href=
      * "https://docs.oracle.com/en/java/javase/17/docs/specs/jni/functions.html#getstaticmethodid">GetStaticMethodID</a>.
      * <p>
-     * This API is deprecated; use {@link JNIAccess} instead.
+     * This API is deprecated; use the {@link JNIAccess} instead.
      *
      * @since 22.3
      */
     public static void register(Executable... methods) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeJNIAccessSupport.class).register(AccessCondition.unconditional(), false, methods);
     }
 
@@ -94,11 +99,12 @@ public static void register(Executable... methods) {
      * or <a href=
      * "https://docs.oracle.com/en/java/javase/17/docs/specs/jni/functions.html#getstaticfieldid">GetStaticFieldID</a>.
      * <p>
-     * This API is deprecated; use {@link JNIAccess} instead.
+     * This API is deprecated; use the {@link JNIAccess} instead.
      *
      * @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,16 +56,19 @@
 @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
      * fully specified by the interfaces it implements.
      * <p>
-     * This API is deprecated; use {@link ReflectiveAccess} instead.
+     * This API is deprecated; use the {@link ReflectiveAccess} instead.
      *
      * @since 22.3
      */
     public static void register(Class<?>... interfaces) {
+        deprecationFlag.printDeprecationWarning();
         ImageSingletons.lookup(RuntimeProxyCreationSupport.class).addProxyClass(AccessCondition.unconditional(), interfaces);
     }