Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Tworzenie obiektów przez refleksję: Constructor.newInstance

Wywołaj konkretny konstruktor w Java SE 21 i odróżnij błąd wyszukiwania lub wywołania od wyjątku zgłoszonego przez sam konstruktor.

Wersja: Java SE 21

Składnia

public T newInstance(Object... initargs)
    throws InstantiationException, IllegalAccessException,
           IllegalArgumentException, InvocationTargetException

Metoda Constructor.newInstance z pakietu java.lang.reflect wywołuje konstruktor reprezentowany przez obiekt Constructor<T> i zwraca nową instancję typu T. Najpierw wybierz konstruktor według dokładnych typów jego parametrów formalnych, w kolejności deklaracji. getConstructor(...) wyszukuje tylko konstruktory publiczne, a getDeclaredConstructor(...) również niepubliczne, lecz samo wyszukanie nie daje prawa do wywołania. Brak dopasowania powoduje NoSuchMethodException na etapie wyszukiwania.

Podczas wywołania przekaż wartości, nie obiekty Class opisujące ich typy. Metoda nie wybiera ponownie przeciążenia. Refleksja może rozpakować typ opakowujący i wykonać konwersję rozszerzającą typu prostego, ale nie wykona konwersji zawężającej. Konstruktor bez parametrów wywołaj przez ctor.newInstance(). Jeśli parametr konstruktora jest tablicą, także w deklaracji varargs, przekaż gotową tablicę jako jeden argument; rzutowanie tablicy referencyjnej na (Object) zapobiega potraktowaniu jej jako całej listy argumentów newInstance. Dla niestatycznej klasy składowej pierwszy argument to instancja klasy otaczającej.

Przy obowiązującej kontroli dostępu niedostępny konstruktor powoduje IllegalAccessException. trySetAccessible() może zwrócić false, jeśli reguły modułów nie pozwalają wyłączyć kontroli dostępu. Zła liczba argumentów, niezgodny typ argumentu lub próba utworzenia instancji wyliczenia powoduje IllegalArgumentException, a klasa abstrakcyjna — InstantiationException. Jeśli wywołanie doprowadzi do błędu inicjalizacji klasy, może wystąpić ExceptionInInitializerError.

Jeżeli wyjątek zgłosi sam konstruktor, refleksja opakuje go w sprawdzany wyjątek InvocationTargetException; pierwotną przyczynę odczytasz przez getCause(). To odróżnia błąd wewnątrz konstruktora od odrzucenia wywołania przez refleksję. Przestarzałe Class.newInstance() może wywołać tylko konstruktor bez parametrów i przekazuje jego wyjątek bez opakowania.

Przykłady

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());
        }
    }
}

Wynik

Java 21
NegativeArraySizeException

Konstruktor `StringBuilder(String)` tworzy obiekt, do którego dopisujemy `" 21"`. Następnie `StringBuilder(int)` odrzuca pojemność `-1`: blok `catch` przechwytuje `InvocationTargetException` i wypisuje nazwę typu pierwotnej przyczyny. Pozostałe sprawdzane błędy refleksji są przekazywane dalej.

Powiązane lekcje

  • Java · Lekcja 13 · Zaawansowany · Wersja: 2

Źródła