Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Vytváření objektů reflexí pomocí Constructor.newInstance

Vyvolej konkrétní konstruktor v Java SE 21 a rozliš chyby při vyhledání nebo volání od výjimek vyvolaných samotným konstruktorem.

Verze: Java SE 21

Syntaxe

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

Constructor.newInstance z balíčku java.lang.reflect zavolá konstruktor reprezentovaný objektem Constructor<T> a vrátí novou instanci typu T. Nejprve vyber konstruktor podle přesných typů formálních parametrů v pořadí deklarace. getConstructor(...) hledá pouze veřejné konstruktory; getDeclaredConstructor(...) najde i neveřejné, ale jejich nalezení ještě neopravňuje k volání. Bez shody vyhledávání skončí výjimkou NoSuchMethodException.

Při volání předávej hodnoty, nikoli objekty Class popisující jejich typy. Přetížená varianta se znovu nevybírá. Reflexe umí rozbalit hodnoty obalových typů a provést rozšiřující konverzi primitivního typu, nikoli zužující. Konstruktor bez parametrů zavolej pomocí ctor.newInstance(). U parametru typu pole, včetně parametru varargs konstruktoru, předej připravené pole jako jeden argument. Přetypování pole referencí na (Object) zabrání tomu, aby se použilo jako celý seznam argumentů newInstance. U nestatické členské třídy je prvním argumentem instance obklopující třídy.

Pokud se uplatňují kontroly přístupu, nepřístupný konstruktor způsobí IllegalAccessException. trySetAccessible() může vrátit false, jestliže pravidla modulů brání vypnutí těchto kontrol. Nesprávný počet argumentů, nekompatibilní argument nebo pokus vytvořit instanci výčtového typu způsobí IllegalArgumentException; abstraktní třída způsobí InstantiationException. Pokud volání spustí inicializaci třídy a ta selže, může nastat ExceptionInInitializerError.

Vyvolá-li výjimku samotný konstruktor, reflexe ji zabalí do kontrolované výjimky InvocationTargetException. Původní příčinu získáš přes getCause(). Tak odlišíš výjimku uvnitř konstruktoru od volání odmítnutého reflexí. Zastaralá metoda Class.newInstance() umí zavolat pouze konstruktor bez parametrů a jeho výjimku předá bez zabalení.

Příklady

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

Výsledek

Java 21
NegativeArraySizeException

`StringBuilder(String)` vytvoří objekt, ke kterému program připojí `" 21"`. Poté `StringBuilder(int)` odmítne kapacitu `-1`: blok `catch` zachytí `InvocationTargetException` a vypíše název typu původní příčiny. Ostatní kontrolované výjimky reflexe se předávají dál.

Související lekce

  • Java · Lekce 13 · Pokročilá · Verze: 2

Zdroje