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

CKTIS / Java

Constructor — pregledovanje in klicanje konstruktorjev z refleksijo

java.lang.reflect.Constructor<T> opisuje en konstruktor razreda T. Omogoča vpogled v tipe parametrov in anotacije ter ustvarjanje objektov ob upoštevanju preverjanja dostopa in meja modulov v Java SE 21.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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> predstavlja en konstruktor razreda T, ne ustvarjenega objekta. Class.getConstructor(...) poišče javni konstruktor, Class.getDeclaredConstructor(...) pa najde tudi nejavne konstruktorje, deklarirane v tem razredu. Iskanje zahteva natančne tipe parametrov: int.class in Integer.class nista zamenljiva. Že samo iskanje konstruktorja ne daje pravice do njegovega klica.

Constructor.getParameterTypes() vrne polje Class<?>[] v vrstnem redu deklaracije; pri konstruktorju brez parametrov je prazno. Vsebuje lahko implicitne parametre, na primer obdajajočo instanco nestatičnega notranjega razreda. Podedovana metoda Constructor.isAnnotationPresent(...) preveri, ali je anotacija prisotna na konstruktorju, ne pa na njegovih parametrih. Anotacija mora imeti RetentionPolicy.RUNTIME, da je dostopna prek refleksije.

Constructor.setAccessible(true) zahteva izklop preverjanja dostopa v jeziku Java; deklaracije konstruktorja ne spremeni. Mej modulov ne more poljubno zaobiti: za dostop do zasebnega konstruktorja v drugem modulu mora biti njegov paket odprt kličočemu modulu. Zavrnitev lahko povzroči InaccessibleObjectException ali SecurityException. setAccessible(false) obnovi preverjanje, trySetAccessible() pa lahko vrne false, če dostopa ni mogoče omogočiti. Namesto opiranja na zasebne konstruktorje knjižnic raje uporabi dostopne javne API-je.

Constructor.newInstance(...) ustvari in inicializira objekt. Podpira razpakiranje argumentov in dovoljene razširitvene pretvorbe, ne pa zoževalnih. Neveljavni argumenti povzročijo IllegalArgumentException, nedostopen konstruktor IllegalAccessException, abstraktni razred pa InstantiationException. Izjema, ki jo sproži konstruktor, je ovita v InvocationTargetException; vzrok preveri z getCause().

Primer uporablja ločen vrhnji razred Item, zato Main nima posebnega dostopa kot član istega gnezda do njegovega zasebnega konstruktorja. Na classpath setAccessible(true) omogoči klic. Ta zapis obravnava Java SE 21; produkcijsko izvajalno okolje ni bilo potrjeno.

Primeri

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

Rezultat

[class java.lang.String]
true
Ada

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri