CKTIS / Java
Създаване на обекти чрез рефлексия с Constructor.newInstance
Извикай конкретен конструктор в Java SE 21 и различи грешките при търсене или извикване от изключенията, хвърлени от самия конструктор.
Версия: Java SE 21
Синтаксис
public T newInstance(Object... initargs)
throws InstantiationException, IllegalAccessException,
IllegalArgumentException, InvocationTargetExceptionConstructor.newInstance от пакета java.lang.reflect извиква конструктора, представен от обект Constructor<T>, и връща нова инстанция от тип T. Първо избери конструктора по точните типове на формалните му параметри в реда на декларацията. getConstructor(...) търси само публични конструктори, а getDeclaredConstructor(...) намира и непублични, но намирането им не дава право да ги извикаш. Ако няма съвпадение, търсенето хвърля NoSuchMethodException.
При извикване подай стойности, а не обекти Class, описващи техните типове. Не се прави повторен избор между претоварените конструктори. Рефлексията може да разопакова стойности от обвиващи типове и да приложи разширяващо преобразуване на примитивен тип, но не и стесняващо. За конструктор без параметри извикай ctor.newInstance(). За параметър от тип масив, включително varargs параметър на конструктора, подай готов масив като един аргумент. Преобразуването на масив от референции към (Object) предотвратява използването му като целия списък с аргументи на newInstance. За нестатичен клас член първият аргумент е инстанцията на обграждащия клас.
Ако проверките за достъп са в сила, недостъпен конструктор води до IllegalAccessException. trySetAccessible() може да върне false, ако правилата на модулите не позволяват изключване на тези проверки. Неправилен брой аргументи, несъвместим аргумент или опит за създаване на инстанция на изброим тип води до IllegalArgumentException, а абстрактен клас — до InstantiationException. Ако извикването задейства инициализация на класа и тя се провали, може да възникне ExceptionInInitializerError.
Ако самият конструктор хвърли изключение, рефлексията го обвива в проверяваното изключение InvocationTargetException; използвай getCause(), за да видиш първоначалната причина. Така различаваш изключение в конструктора от извикване, отхвърлено от рефлексията. Остарелият метод Class.newInstance() може да извика само конструктор без параметри и предава изключението му без обвиване.
Примери
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());
}
}
}Резултат
Java 21 NegativeArraySizeException
`StringBuilder(String)` създава обект, към който програмата добавя `" 21"`. След това `StringBuilder(int)` отхвърля капацитета `-1`: блокът `catch` прихваща `InvocationTargetException` и отпечатва името на типа на първоначалната причина. Останалите проверявани изключения от рефлексията се предават нагоре.
Свързани уроци
- Java · Урок 13 · Напреднало · Версия: 2
Източници
- 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)