Deprecate ConstructorUtils in favor of Apache Commons Lang's

ConstructorUtils. ConstructorUtils is unused in this component.

Author: garydgregory

src/changes/changes.xml

@@ -36,6 +36,7 @@
       <action dev="ggregory" type="update" due-to="Gary Gregory">Bump org.apache.commons:commons-parent from 84 to 85.</action>
       <!-- REMOVE -->
       <action dev="ggregory" type="remove" due-to="Gary Gregory">Remove pre-Java 1.4 code that will never run since we are on Java 8 or greater.</action>
+      <action dev="ggregory" type="remove" due-to="Gary Gregory">Deprecate ConstructorUtils in favor of Apache Commons Lang's ConstructorUtils. ConstructorUtils is unused in this component.</action>
     </release>
     <release version="1.11.0" date="2025-05-25" description="This is a maintenance release and requires Java 8.">
       <!-- FIX -->

src/main/java/org/apache/commons/beanutils/ConstructorUtils.java

@@ -22,18 +22,24 @@
 import java.lang.reflect.Modifier;
 
 /**
- * <p>Utility reflection methods focused on constructors, modeled after {@link MethodUtils}.</p>
+ * <p>
+ * Utility reflection methods focused on constructors, modeled after {@link MethodUtils}.
+ * </p>
  *
  * <strong>Known Limitations: Accessing Public Constructors In A Default Access Superclass</strong>
- * <p>There is an issue when invoking public constructors contained in a default access superclass.
- * Reflection locates these constructors fine and correctly assigns them as public.
- * However, an {@code IllegalAccessException} is thrown if the constructors is invoked.</p>
+ * <p>
+ * There is an issue when invoking public constructors contained in a default access superclass. Reflection locates these constructors fine and correctly
+ * assigns them as public. However, an {@code IllegalAccessException} is thrown if the constructors is invoked.
+ * </p>
  *
- * <p>{@code ConstructorUtils} contains a workaround for this situation.
- * It will attempt to call {@code setAccessible} on this constructor.
- * If this call succeeds, then the method can be invoked as normal.
- * This call will only succeed when the application has sufficient security privileges.
- * If this call fails then a warning will be logged and the method may fail.</p>
+ * <p>
+ * {@code ConstructorUtils} contains a workaround for this situation. It will attempt to call {@code setAccessible} on this constructor. If this call succeeds,
+ * then the method can be invoked as normal. This call will only succeed when the application has sufficient security privileges. If this call fails then a
+ * warning will be logged and the method may fail.
+ * </p>
+ *
+ * @deprecated Use <a href="https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/ConstructorUtils.html">ConstructorUtils from
+ *             Apache Commons Lang</a>. ConstructorUtils is unused in this component.
  */
 public class ConstructorUtils {
 

src/test/java/org/apache/commons/beanutils/ConstructorUtilsTestCase.java

@@ -25,9 +25,9 @@
 import junit.framework.TestSuite;
 
 /**
- * <p> Test case for {@code ConstructorUtils} </p>
- *
+ * Tests {@link ConstructorUtils} </p>
  */
+@SuppressWarnings("deprecation")
 public class ConstructorUtilsTestCase extends TestCase {
 
     /**