Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Class.getDeclaredConstructor — procurar um construtor declarado

Procura um construtor pelos tipos exatos dos parâmetros e cria o objeto num passo separado. O exemplo usa o construtor público sem argumentos de StringBuilder sem contornar as verificações de acesso.

Versão: Java SE 21

Sintaxe

public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
    throws NoSuchMethodException, SecurityException

Em Java SE 21, Class.getDeclaredConstructor procura um construtor declarado pela classe representada por Class<T> e devolve um java.lang.reflect.Constructor<T>. Pode encontrar construtores não públicos, incluindo os privados. getConstructor procura apenas construtores públicos. Os construtores não são herdados.

Indica os tipos exatos dos parâmetros formais pela ordem em que foram declarados, não os valores dos argumentos. getDeclaredConstructor() sem argumentos procura um construtor sem parâmetros. int.class e Integer.class não são intercambiáveis: a pesquisa não aplica autoboxing nem escolhe uma sobrecarga com base na compatibilidade de atribuição. Para uma classe membro não estática, indica primeiro o tipo da classe envolvente na pesquisa e passa uma instância envolvente como primeiro argumento ao invocar o construtor.

Se nenhum construtor corresponder, a pesquisa lança NoSuchMethodException. Em Java SE 21, um gestor de segurança instalado também pode impedir a pesquisa, provocando SecurityException. Encontrar o construtor não dá permissão para o invocar nem cria um objeto.

Para criar o objeto, chama Constructor.newInstance com os valores dos argumentos. Se as verificações de acesso recusarem a invocação, o método lança IllegalAccessException. Se o próprio construtor lançar uma exceção, newInstance encapsula-a em InvocationTargetException. O exemplo usa o construtor público StringBuilder() sem contornar as verificações de acesso.

Exemplos

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

A primeira instrução procura o construtor e a segunda cria um `StringBuilder` vazio. Depois de acrescentar o texto, o programa escreve `Java` na consola.

Lições relacionadas

  • Java · Lição 13 · Avançado · Versão: 2

Fontes