Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Ustvarjanje objektov z refleksijo: Constructor.newInstance

Pokliči določen konstruktor v Java SE 21 in loči napake pri iskanju ali klicu od izjem, ki jih sproži sam konstruktor.

Različica: Java SE 21

Sintaksa

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

Constructor.newInstance iz paketa java.lang.reflect pokliče konstruktor, ki ga predstavlja objekt Constructor<T>, in vrne nov primerek tipa T. Konstruktor najprej izberi po natančnih tipih formalnih parametrov v vrstnem redu deklaracije. getConstructor(...) išče samo javne konstruktorje, getDeclaredConstructor(...) pa najde tudi nejavne, vendar najdba še ne dovoli klica. Če zadetka ni, iskanje sproži NoSuchMethodException.

Pri klicu podaj vrednosti, ne objektov Class, ki opisujejo njihove tipe. Različica preobremenjenega konstruktorja se ne izbira znova. Refleksija lahko vrednost ovojnega tipa pretvori v primitivno vrednost in uporabi razširitveno pretvorbo primitivnega tipa, ne pa zožitvene. Konstruktor brez parametrov pokliči z ctor.newInstance(). Za parameter tipa polja, tudi pri parametru varargs konstruktorja, podaj pripravljeno polje kot en argument. Pretvorba polja referenc v (Object) prepreči, da bi ga newInstance uporabil kot celoten seznam argumentov. Pri nestatičnem članskem razredu je prvi argument primerek obdajajočega razreda.

Če veljajo preverjanja dostopa, nedostopen konstruktor povzroči IllegalAccessException. trySetAccessible() lahko vrne false, če pravila modulov ne dovoljujejo izklopa teh preverjanj. Napačno število argumentov, nezdružljiv argument ali poskus ustvarjanja primerka naštevnega tipa povzroči IllegalArgumentException; abstraktni razred povzroči InstantiationException. Če klic sproži inicializacijo razreda in ta ne uspe, se lahko pojavi ExceptionInInitializerError.

Če izjemo sproži sam konstruktor, jo refleksija ovije v preverjano izjemo InvocationTargetException; prvotni vzrok pridobiš z getCause(). Tako ločiš izjemo v konstruktorju od klica, ki ga je refleksija zavrnila. Zastarela metoda Class.newInstance() lahko pokliče le konstruktor brez parametrov in njegovo izjemo posreduje brez ovijanja.

Primeri

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

Rezultat

Java 21
NegativeArraySizeException

`StringBuilder(String)` ustvari objekt, ki mu program doda `" 21"`. Nato `StringBuilder(int)` zavrne kapaciteto `-1`: blok `catch` prestreže `InvocationTargetException` in izpiše ime tipa prvotnega vzroka. Druge preverjane izjeme refleksije se posredujejo naprej.

Povezane lekcije

  • Java · Lekcija 13 · Napredna · Različica: 2

Viri