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

CKTIS / Java

Constructor — inspecionar e invocar construtores através de reflexão

java.lang.reflect.Constructor<T> descreve um construtor da classe T. Permite consultar os tipos dos parâmetros e as anotações, e criar objetos, respeitando os controlos de acesso e os limites entre módulos do Java SE 21.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

Constructor<T> ctor = type.getDeclaredConstructor(parameterTypes);
Class<?>[] types = ctor.getParameterTypes();
boolean annotated = ctor.isAnnotationPresent(annotationType);
ctor.setAccessible(true);
T instance = ctor.newInstance(arguments);

java.lang.reflect.Constructor<T> representa um construtor da classe T, não um objeto construído. Class.getConstructor(...) procura um construtor público, enquanto Class.getDeclaredConstructor(...) encontra também os construtores não públicos declarados nessa classe. A pesquisa exige os tipos exatos dos parâmetros: int.class e Integer.class não são permutáveis. Encontrar um construtor não concede, por si só, autorização para o invocar.

Constructor.getParameterTypes() devolve uma matriz Class<?>[] pela ordem de declaração; fica vazia se o construtor não tiver parâmetros. Pode incluir parâmetros implícitos, como a instância envolvente de uma classe interna não estática. O método herdado Constructor.isAnnotationPresent(...) verifica uma anotação do construtor, não dos seus parâmetros. Para estar disponível através de reflexão, uma anotação tem de ter RetentionPolicy.RUNTIME.

Constructor.setAccessible(true) solicita a supressão dos controlos de acesso da linguagem Java; não altera a declaração do construtor. Não permite contornar arbitrariamente os limites entre módulos: para aceder a um construtor privado noutro módulo, o pacote tem de estar aberto ao módulo que o invoca. A recusa pode originar InaccessibleObjectException ou SecurityException. setAccessible(false) repõe os controlos, enquanto trySetAccessible() pode devolver false se não for possível ativar o acesso. Prefira APIs públicas acessíveis a depender de construtores privados de bibliotecas.

Constructor.newInstance(...) cria e inicializa um objeto. Suporta o desempacotamento de argumentos e as conversões de alargamento permitidas, mas não as de estreitamento. Argumentos inválidos causam IllegalArgumentException, a falta de acesso causa IllegalAccessException e as classes abstratas causam InstantiationException. Uma exceção lançada pelo construtor é encapsulada em InvocationTargetException; consulte a causa com getCause().

O exemplo utiliza a classe de topo separada Item, pelo que Main não tem acesso especial de membro do mesmo ninho ao seu construtor privado. No class path, setAccessible(true) permite a invocação. Esta entrada destina-se ao Java SE 21; o ambiente de produção não foi atestado.

Exemplos

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Constructor;
import java.util.Arrays;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.CONSTRUCTOR)
@interface Selected {}

final class Item {
    final String name;

    @Selected
    private Item(String name) {
        this.name = name;
    }
}

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Constructor<Item> ctor = Item.class.getDeclaredConstructor(String.class);
        System.out.println(Arrays.toString(ctor.getParameterTypes()));
        System.out.println(ctor.isAnnotationPresent(Selected.class));
        ctor.setAccessible(true);
        Item item = ctor.newInstance("Ada");
        System.out.println(item.name);
    }
}

Resultado

[class java.lang.String]
true
Ada

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes