KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Objecten maken via reflectie met Constructor.newInstance

Roep in Java SE 21 een specifieke constructor aan en onderscheid fouten bij het opzoeken of aanroepen van excepties uit de constructor zelf.

Versie: Java SE 21

Syntax

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

Constructor.newInstance uit java.lang.reflect roept de constructor aan die een Constructor<T>-object vertegenwoordigt en geeft een nieuwe instantie van type T terug. Selecteer eerst de constructor aan de hand van de exacte formele parametertypen in declaratievolgorde. getConstructor(...) zoekt alleen openbare constructors; getDeclaredConstructor(...) vindt ook niet-openbare constructors, maar dat geeft nog geen toegang om ze aan te roepen. Zonder overeenkomst krijg je bij het opzoeken NoSuchMethodException.

Geef bij de aanroep waarden door, geen Class-objecten die hun typen beschrijven. Er wordt niet opnieuw een overload gekozen. Reflectie kan wrapperwaarden uitpakken en primitieve typen verruimen, maar niet vernauwen. Roep een constructor zonder parameters aan met ctor.newInstance(). Geef voor een arrayparameter, ook een varargs-parameter van de constructor, een kant-en-klare array als één argument door. Een cast van een referentiearray naar (Object) voorkomt dat die als de volledige argumentenlijst van newInstance dient. Voor een niet-statische lidklasse is de omsluitende instantie het eerste argument.

Als toegangscontroles actief zijn, leidt een ontoegankelijke constructor tot IllegalAccessException. trySetAccessible() kan false teruggeven als moduleregels het uitschakelen van die controles verhinderen. Een verkeerd aantal argumenten, een incompatibel argument of een poging een enum te instantiëren leidt tot IllegalArgumentException; een abstracte klasse leidt tot InstantiationException. Als de aanroep klasse-initialisatie start en die mislukt, kan ExceptionInInitializerError optreden.

Gooit de constructor zelf een exceptie, dan verpakt reflectie die in de gecontroleerde InvocationTargetException; bekijk de oorspronkelijke oorzaak met getCause(). Zo onderscheid je een exceptie in de constructor van een aanroep die reflectie weigert. Het verouderde Class.newInstance() kan alleen een constructor zonder parameters aanroepen en geeft diens exceptie onverpakt door.

Voorbeelden

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

Resultaat

Java 21
NegativeArraySizeException

`StringBuilder(String)` maakt een object waaraan het programma `" 21"` toevoegt. Daarna weigert `StringBuilder(int)` de capaciteit `-1`: het `catch`-blok vangt `InvocationTargetException` op en drukt de typenaam van de oorspronkelijke oorzaak af. Andere gecontroleerde reflectie-excepties worden doorgegeven.

Gerelateerde lessen

  • Java · Les 13 · Gevorderd · Versie: 2

Bronnen