CKTIS / Java
Criar objetos por reflexão com Constructor.newInstance
Invoca um construtor específico em Java SE 21 e distingue falhas de pesquisa ou de invocação de exceções lançadas pelo próprio construtor.
Versão: Java SE 21
Sintaxe
public T newInstance(Object... initargs)
throws InstantiationException, IllegalAccessException,
IllegalArgumentException, InvocationTargetExceptionConstructor.newInstance, de java.lang.reflect, invoca o construtor representado por um objeto Constructor<T> e devolve uma nova instância do tipo T. Primeiro, seleciona o construtor pelos tipos exatos dos parâmetros formais, na ordem da declaração. getConstructor(...) procura apenas construtores públicos; getDeclaredConstructor(...) encontra também os não públicos, mas encontrá-los não dá permissão para os invocar. Se não houver correspondência, a pesquisa lança NoSuchMethodException.
Na invocação, passa os valores em vez dos objetos Class que descrevem os seus tipos. Não se volta a selecionar uma sobrecarga. A reflexão permite desempacotar valores e alargar tipos primitivos, mas não os pode estreitar. Para um construtor sem parâmetros, chama ctor.newInstance(). Para um parâmetro do tipo array, incluindo um parâmetro varargs do construtor, passa um array já preparado como um único argumento; converter um array de referências para (Object) impede que seja usado como a lista completa de argumentos de newInstance. Numa classe membro não estática, o primeiro argumento é a instância envolvente.
Quando as verificações de acesso estão ativas, um construtor inacessível provoca IllegalAccessException. trySetAccessible() pode devolver false se as regras dos módulos impedirem a desativação dessas verificações. Um número errado de argumentos, um argumento incompatível ou uma tentativa de instanciar um tipo enum provoca IllegalArgumentException; uma classe abstrata provoca InstantiationException. Se a invocação desencadear uma inicialização de classe que falhe, pode ocorrer ExceptionInInitializerError.
Se o próprio construtor lançar uma exceção, a reflexão encapsula-a na exceção verificada InvocationTargetException; usa getCause() para consultar a causa original. Assim, distingues uma exceção interna ao construtor de uma chamada rejeitada pela reflexão. O método obsoleto Class.newInstance() só pode invocar um construtor sem parâmetros e propaga a sua exceção sem a encapsular.
Exemplos
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
public class ConstructorDemo {
public static void main(String[] args) throws ReflectiveOperationException {
Constructor<StringBuilder> fromText =
StringBuilder.class.getConstructor(String.class);
StringBuilder builder = fromText.newInstance("Java");
System.out.println(builder.append(" 21"));
Constructor<StringBuilder> fromCapacity =
StringBuilder.class.getConstructor(int.class);
try {
fromCapacity.newInstance(-1);
throw new AssertionError("Expected a negative capacity to fail");
} catch (InvocationTargetException e) {
System.out.println(e.getCause().getClass().getSimpleName());
}
}
}Resultado
Java 21 NegativeArraySizeException
`StringBuilder(String)` cria um objeto ao qual o programa acrescenta `" 21"`. Depois, `StringBuilder(int)` rejeita a capacidade `-1`: o bloco `catch` interceta `InvocationTargetException` e imprime o nome do tipo da causa original. As restantes exceções verificadas da reflexão são propagadas.
Lições relacionadas
- Java · Lição 13 · Avançado · Versão: 2
Fontes
- Java SE 21 API — Constructor.newInstance(Object...)
- Java SE 21 API — Class.getConstructor(Class<?>...)
- Java SE 21 API — Class.getDeclaredConstructor(Class<?>...)
- Java SE 21 API — AccessibleObject.trySetAccessible()
- Java SE 21 API — InvocationTargetException.getCause()
- Java SE 21 API — StringBuilder(String)
- Java SE 21 API — StringBuilder(int)
- Java SE 21 API — Class.newInstance() (deprecated)