CKTIS / Java
Vytváranie objektov reflexiou pomocou Constructor.newInstance
Zavolaj konkrétny konštruktor v Java SE 21 a rozlíš chyby pri vyhľadávaní alebo volaní od výnimiek vyvolaných samotným konštruktorom.
Verzia: Java SE 21
Syntax
public T newInstance(Object... initargs)
throws InstantiationException, IllegalAccessException,
IllegalArgumentException, InvocationTargetExceptionConstructor.newInstance z balíka java.lang.reflect zavolá konštruktor reprezentovaný objektom Constructor<T> a vráti novú inštanciu typu T. Najprv vyber konštruktor podľa presných typov formálnych parametrov v poradí deklarácie. getConstructor(...) vyhľadáva len verejné konštruktory; getDeclaredConstructor(...) nájde aj neverejné, ale ich nájdenie ešte neoprávňuje na volanie. Ak sa zhoda nenájde, vyhľadávanie vyvolá NoSuchMethodException.
Pri volaní odovzdaj hodnoty, nie objekty Class opisujúce ich typy. Preťažený variant sa znova nevyberá. Reflexia dokáže rozbaliť hodnoty obalových typov a vykonať rozširujúcu konverziu primitívneho typu, nie však zužujúcu. Konštruktor bez parametrov zavolaj cez ctor.newInstance(). Pri parametri typu pole, vrátane parametra varargs konštruktora, odovzdaj pripravené pole ako jeden argument. Pretypovanie poľa referencií na (Object) zabráni jeho použitiu ako celého zoznamu argumentov newInstance. Pri nestatickej členskej triede je prvým argumentom inštancia obklopujúcej triedy.
Ak sa vykonávajú kontroly prístupu, neprístupný konštruktor spôsobí IllegalAccessException. trySetAccessible() môže vrátiť false, ak pravidlá modulov neumožňujú vypnúť tieto kontroly. Nesprávny počet argumentov, nekompatibilný argument alebo pokus o vytvorenie inštancie výčtového typu spôsobí IllegalArgumentException; abstraktná trieda spôsobí InstantiationException. Ak volanie spustí inicializáciu triedy a tá zlyhá, môže nastať ExceptionInInitializerError.
Ak výnimku vyvolá samotný konštruktor, reflexia ju zabalí do kontrolovanej výnimky InvocationTargetException. Pôvodnú príčinu zistíš pomocou getCause(). Tak odlíšiš výnimku v konštruktore od volania odmietnutého reflexiou. Zastaraná metóda Class.newInstance() dokáže zavolať iba konštruktor bez parametrov a jeho výnimku odovzdá bez zabalenia.
Prí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ýsledok
Java 21 NegativeArraySizeException
`StringBuilder(String)` vytvorí objekt, ku ktorému program pripojí `" 21"`. Potom `StringBuilder(int)` odmietne kapacitu `-1`: blok `catch` zachytí `InvocationTargetException` a vypíše názov typu pôvodnej príčiny. Ostatné kontrolované výnimky reflexie sa šíria ďalej.
Súvisiace lekcie
- Java · Lekcia 13 · Pokročilá · Verzia: 2
Zdroje
- 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)