diff --git a/src/main/java/org/apache/commons/lang3/ArrayUtils.java b/src/main/java/org/apache/commons/lang3/ArrayUtils.java index 4369d4f7e03..c63bd365bf9 100644 --- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java +++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java @@ -194,9 +194,18 @@ public class ArrayUtils { * The {@code SOFT_MAX_ARRAY_LENGTH} constant from Java's internal ArraySupport class. * * @since 3.19.0 + * @deprecated This variable will be final in 4.0; to guarantee immutability now, use {@link #SAFE_MAX_ARRAY_LENGTH}. */ + @Deprecated public static int SOFT_MAX_ARRAY_LENGTH = Integer.MAX_VALUE - 8; + /** + * The {@code MAX_ARRAY_LENGTH} constant from Java's internal ArraySupport class. + * + * @since 3.21.0 + */ + public static final int SAFE_MAX_ARRAY_LENGTH = Integer.MAX_VALUE - 8; + /** * Copies the given array and adds the given element at the end of the new array. *
diff --git a/src/test/java/org/apache/commons/lang3/ArrayUtilsTest.java b/src/test/java/org/apache/commons/lang3/ArrayUtilsTest.java
index cb3a38eeaeb..a6ff321b9c5 100644
--- a/src/test/java/org/apache/commons/lang3/ArrayUtilsTest.java
+++ b/src/test/java/org/apache/commons/lang3/ArrayUtilsTest.java
@@ -6958,4 +6958,9 @@ void testToStringDefault() {
assertEquals("{