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.