Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Constructor — skúmanie a volanie konštruktorov pomocou reflexie

java.lang.reflect.Constructor<T> opisuje jeden konštruktor triedy T. Umožňuje zistiť typy parametrov a anotácie a vytvárať objekty pri rešpektovaní riadenia prístupu a hraníc modulov v Java SE 21.

Verzia: 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> predstavuje jeden konštruktor triedy T, nie vytvorený objekt. Class.getConstructor(...) vyhľadá verejný konštruktor, zatiaľ čo Class.getDeclaredConstructor(...) nájde aj neverejné konštruktory deklarované v danej triede. Vyhľadávanie vyžaduje presné typy parametrov: int.class a Integer.class nie sú zameniteľné. Nájdenie konštruktora samo osebe nedáva oprávnenie na jeho zavolanie.

Constructor.getParameterTypes() vráti pole Class<?>[] v poradí deklarácie; ak konštruktor nemá parametre, pole je prázdne. Môže obsahovať implicitné parametre, napríklad obklopujúcu inštanciu nestatickej vnorenej triedy. Zdedená metóda Constructor.isAnnotationPresent(...) kontroluje anotáciu konštruktora, nie jeho parametrov. Anotácia musí mať RetentionPolicy.RUNTIME, aby bola dostupná cez reflexiu.

Constructor.setAccessible(true) žiada o potlačenie kontrol prístupu jazyka Java; deklaráciu konštruktora nemení. Hranice modulov nemožno ľubovoľne obísť: prístup k súkromnému konštruktoru v inom module vyžaduje otvorenie jeho balíka volajúcemu modulu. Odmietnutie môže vyvolať InaccessibleObjectException alebo SecurityException. setAccessible(false) obnoví kontroly a trySetAccessible() môže vrátiť false, ak prístup nemožno povoliť. Uprednostni prístupné verejné API pred spoliehaním sa na súkromné konštruktory knižníc.

Constructor.newInstance(...) vytvorí a inicializuje objekt. Podporuje rozbalenie argumentov a povolené rozširujúce konverzie, nie však zužujúce konverzie. Nesprávne argumenty spôsobia IllegalArgumentException, nedostupný konštruktor IllegalAccessException a abstraktná trieda InstantiationException. Výnimka vyvolaná konštruktorom sa zabalí do InvocationTargetException; jej príčinu zistíš pomocou getCause().

Príklad používa samostatnú najvyššiu triedu Item, takže Main nemá osobitný prístup ako člen rovnakého hniezda k jej súkromnému konštruktoru. Na classpath umožní volanie setAccessible(true). Tento záznam sa týka Java SE 21; produkčné prostredie nebolo potvrdené.

Príklady

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

Výsledok

[class java.lang.String]
true
Ada

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje