KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Constructor — constructors onderzoeken en aanroepen via reflectie

java.lang.reflect.Constructor<T> beschrijft één constructor van klasse T. Je kunt er parametertypen en annotaties mee opvragen en objecten maken, met inachtneming van toegangscontroles en modulegrenzen in Java SE 21.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

Constructor<T> ctor = type.getDeclaredConstructor(parameterTypes);
Class<?>[] types = ctor.getParameterTypes();
boolean annotated = ctor.isAnnotationPresent(annotationType);
ctor.setAccessible(true);
T instance = ctor.newInstance(arguments);

java.lang.reflect.Constructor<T> stelt één constructor van klasse T voor, niet een aangemaakt object. Class.getConstructor(...) zoekt een publieke constructor; Class.getDeclaredConstructor(...) vindt ook niet-publieke constructors die in die klasse zijn gedeclareerd. De zoekopdracht vereist exact overeenkomende parametertypen: int.class en Integer.class zijn niet uitwisselbaar. Een constructor vinden geeft op zichzelf geen toestemming om die aan te roepen.

Constructor.getParameterTypes() retourneert een array Class<?>[] in declaratievolgorde; bij een constructor zonder parameters is die leeg. De array kan impliciete parameters bevatten, zoals de omvattende instantie van een niet-statische inner class. De overgeërfde methode Constructor.isAnnotationPresent(...) controleert een annotatie op de constructor, niet op de parameters. Een annotatie moet RetentionPolicy.RUNTIME hebben om via reflectie beschikbaar te zijn.

Constructor.setAccessible(true) vraagt om onderdrukking van de toegangscontroles van de Java-taal; de constructordeclaratie verandert hierdoor niet. Modulegrenzen kunnen niet zomaar worden omzeild: voor toegang tot een private constructor in een andere module moet het pakket zijn geopend voor de aanroepende module. Een weigering kan InaccessibleObjectException of SecurityException opleveren. setAccessible(false) herstelt de controles; trySetAccessible() kan false retourneren als toegang niet kan worden ingeschakeld. Geef de voorkeur aan toegankelijke publieke API’s boven afhankelijkheid van private library-constructors.

Constructor.newInstance(...) maakt en initialiseert een object. De methode ondersteunt het uitpakken van argumenten en toegestane verbredende conversies, maar geen vernauwende conversies. Ongeldige argumenten veroorzaken IllegalArgumentException, ontbrekende toegang veroorzaakt IllegalAccessException en abstracte klassen veroorzaken InstantiationException. Een uitzondering die de constructor gooit, wordt verpakt in InvocationTargetException; bekijk de oorzaak met getCause().

Het voorbeeld gebruikt de afzonderlijke top-levelklasse Item; daarom heeft Main geen speciale nestgenoottoegang tot de private constructor. Op de classpath maakt setAccessible(true) de aanroep mogelijk. Dit artikel betreft Java SE 21; de productieomgeving is niet bevestigd.

Voorbeelden

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Constructor;
import java.util.Arrays;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.CONSTRUCTOR)
@interface Selected {}

final class Item {
    final String name;

    @Selected
    private Item(String name) {
        this.name = name;
    }
}

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Constructor<Item> ctor = Item.class.getDeclaredConstructor(String.class);
        System.out.println(Arrays.toString(ctor.getParameterTypes()));
        System.out.println(ctor.isAnnotationPresent(Selected.class));
        ctor.setAccessible(true);
        Item item = ctor.newInstance("Ada");
        System.out.println(item.name);
    }
}

Resultaat

[class java.lang.String]
true
Ada

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen