Deprecate constants for obsolete system properties in SystemUtils

garydgregory · garydgregory · commit e61f79ba2b09 · 2025-09-18T18:04:39.000-04:00
- Deprecate constants for obsolete system property
SystemUtils.JAVA_AWT_FONTS
- Deprecate constants for obsolete system property
SystemUtils.JAVA_AWT_GRAPHICSENV
- Deprecate constants for obsolete system property
SystemUtils.JAVA_AWT_HEADLESS
- Deprecate constants for obsolete system property
SystemUtils.JAVA_AWT_PRINTERJOB
- Deprecate constants for obsolete system property
SystemUtils.JAVA_COMPILER
- Deprecate constants for obsolete system property
SystemUtils.JAVA_ENDORSED_DIRS
- Deprecate constants for obsolete system property
SystemUtils.JAVA_EXT_DIRS
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
@@ -82,6 +82,13 @@ The <action> type attribute can be add,update,fix,remove.
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate method for obsolete system property constant SystemProperties.getJavaEndorsedDirs()</action>
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate method for obsolete system property constant SystemProperties.getJavaExtDirs()</action>
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate method for obsolete system property constant SystemUtils.isJavaAwtHeadless()</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_FONTS.</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_GRAPHICSENV.</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_HEADLESS.</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_PRINTERJOB.</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_COMPILER.</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_ENDORSED_DIRS.</action>
+    <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Deprecate constants for obsolete system property SystemUtils.JAVA_EXT_DIRS.</action>
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">[javadoc] General improvements.</action>
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">[javadoc] Fix thrown exception documentation for MethodUtils.getMethodObject(Class&lt;?&gt;, String, Class&lt;?&gt;...).</action>
     <action                   type="fix" dev="ggregory" due-to="Scott Parish">[javadoc] Strings::equalsAny: CI doc string should show it's insensitive #1416.</action>
diff --git a/src/main/java/org/apache/commons/lang3/SystemUtils.java b/src/main/java/org/apache/commons/lang3/SystemUtils.java
@@ -103,7 +103,9 @@ public class SystemUtils {
      *
      * @see SystemProperties#getJavaAwtFonts()
      * @since 2.1
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_AWT_FONTS = SystemProperties.getJavaAwtFonts();
 
     /**
@@ -119,7 +121,9 @@ public class SystemUtils {
      *
      * @see SystemProperties#getJavaAwtGraphicsenv()
      * @since 2.1
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_AWT_GRAPHICSENV = SystemProperties.getJavaAwtGraphicsenv();
 
     /**
@@ -137,7 +141,9 @@ public class SystemUtils {
      * @see SystemProperties#getJavaAwtHeadless()
      * @since 2.1
      * @since Java 1.4
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_AWT_HEADLESS = SystemProperties.getJavaAwtHeadless();
 
     /**
@@ -153,7 +159,9 @@ public class SystemUtils {
      *
      * @see SystemProperties#getJavaAwtPrinterjob()
      * @since 2.1
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_AWT_PRINTERJOB = SystemProperties.getJavaAwtPrinterjob();
 
     /**
@@ -201,7 +209,9 @@ public class SystemUtils {
      *
      * @see SystemProperties#getJavaCompiler()
      * @since Java 1.2. Not used in Sun versions after 1.2.
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_COMPILER = SystemProperties.getJavaCompiler();
 
     /**
@@ -217,7 +227,9 @@ public class SystemUtils {
      *
      * @see SystemProperties#getJavaEndorsedDirs()
      * @since Java 1.4
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_ENDORSED_DIRS = SystemProperties.getJavaEndorsedDirs();
 
     /**
@@ -233,7 +245,9 @@ public class SystemUtils {
      *
      * @see SystemProperties#getJavaExtDirs()
      * @since Java 1.3
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String JAVA_EXT_DIRS = SystemProperties.getJavaExtDirs();
 
     /**
@@ -864,7 +878,7 @@ public class SystemUtils {
      * </p>
      *
      * @since 3.4
-     * @deprecated As of release 3.5, replaced by {@link #IS_JAVA_9}
+     * @deprecated As of release 3.5, replaced by {@link #IS_JAVA_9}.
      */
     @Deprecated
     public static final boolean IS_JAVA_1_9 = getJavaVersionMatches("9");
@@ -2043,7 +2057,9 @@ public class SystemUtils {
      *
      * @since 2.1
      * @see SystemProperties#getAwtToolkit()
+     * @deprecated Deprecated without replacement.
      */
+    @Deprecated
     public static final String AWT_TOOLKIT = SystemProperties.getAwtToolkit();
 
     /**
