CKTIS / Java
Class.getDeclaredConstructor — buscar un constructor declarado
Busca un constructor por los tipos exactos de sus parámetros y crea el objeto en un paso aparte. El ejemplo usa el constructor público sin argumentos de StringBuilder sin eludir los controles de acceso.
Versión: Java SE 21
Sintaxis
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
throws NoSuchMethodException, SecurityExceptionEn Java SE 21, Class.getDeclaredConstructor busca un constructor declarado por la clase representada por Class<T> y devuelve un java.lang.reflect.Constructor<T>. Puede encontrar constructores no públicos, incluidos los privados. getConstructor solo busca constructores públicos. Los constructores no se heredan.
Pasa los tipos exactos de los parámetros formales en el orden de declaración, no los valores de los argumentos. getDeclaredConstructor() sin argumentos busca un constructor sin parámetros. int.class e Integer.class no son intercambiables: la búsqueda no aplica autoboxing ni selecciona una sobrecarga por compatibilidad de asignación. Para una clase miembro no estática, pasa primero el tipo de la clase envolvente al buscar y una instancia envolvente como primer argumento al invocar el constructor.
Si no hay coincidencia, la búsqueda lanza NoSuchMethodException. En Java SE 21, un gestor de seguridad instalado también puede denegar la búsqueda, lo que provoca SecurityException. Encontrar el constructor no concede permiso para invocarlo ni crea un objeto.
Llama a Constructor.newInstance con los valores de los argumentos para crear el objeto. Si los controles de acceso rechazan la invocación, el método lanza IllegalAccessException. Si el propio constructor lanza una excepción, newInstance la envuelve en InvocationTargetException. El ejemplo usa el constructor público StringBuilder() sin eludir los controles de acceso.
Ejemplos
import java.lang.reflect.Constructor;
public class Main {
public static void main(String[] args) throws ReflectiveOperationException {
Constructor<StringBuilder> constructor = StringBuilder.class.getDeclaredConstructor();
StringBuilder builder = constructor.newInstance();
System.out.println(builder.append("Java").toString());
}
}
Resultado
Java
La primera instrucción busca el constructor; la segunda crea un `StringBuilder` vacío. Después de añadir el texto, el programa imprime `Java`.
Lecciones relacionadas
- Java · Lección 13 · Avanzado · Versión: 2