Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Constructor — pregled i pozivanje konstruktora refleksijom

java.lang.reflect.Constructor<T> opisuje jedan konstruktor klase T. Omogućuje pregled tipova parametara i anotacija te stvaranje objekata uz poštovanje provjera pristupa i granica modula u Java SE 21.

Verzija: 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 jedan konstruktor klase T, a ne stvoreni objekt. Class.getConstructor(...) traži javni konstruktor, dok Class.getDeclaredConstructor(...) pronalazi i nejavne konstruktore deklarirane u toj klasi. Pretraživanje zahtijeva točne tipove parametara: int.class i Integer.class nisu zamjenjivi. Samo pronalaženje konstruktora ne daje pravo na njegovo pozivanje.

Constructor.getParameterTypes() vraća polje Class<?>[] redoslijedom deklaracije; za konstruktor bez parametara polje je prazno. Može sadržavati implicitne parametre, primjerice obuhvatnu instancu nestatičke unutarnje klase. Naslijeđena metoda Constructor.isAnnotationPresent(...) provjerava anotaciju konstruktora, a ne njegovih parametara. Anotacija mora imati RetentionPolicy.RUNTIME da bi bila dostupna refleksijom.

Constructor.setAccessible(true) traži potiskivanje provjera pristupa jezika Java; ne mijenja deklaraciju konstruktora. Ne može proizvoljno zaobići granice modula: za pristup privatnom konstruktoru u drugom modulu njegov paket mora biti otvoren modulu koji poziva. Odbijanje može izazvati InaccessibleObjectException ili SecurityException. setAccessible(false) vraća provjere, a trySetAccessible() može vratiti false ako se pristup ne može omogućiti. Prednost daj dostupnim javnim API-jima, a ne oslanjanju na privatne konstruktore biblioteka.

Constructor.newInstance(...) stvara i inicijalizira objekt. Podržava raspakiravanje argumenata i dopuštene proširujuće pretvorbe, ali ne i sužavajuće. Nevaljani argumenti uzrokuju IllegalArgumentException, nedostupan konstruktor IllegalAccessException, a apstraktna klasa InstantiationException. Iznimka koju baci konstruktor omata se u InvocationTargetException; uzrok provjeri pomoću getCause().

Primjer koristi zasebnu klasu najviše razine Item, pa Main nema poseban pristup kao član istog gnijezda njezinu privatnom konstruktoru. Na class pathu setAccessible(true) omogućuje pozivanje. Ovaj se zapis odnosi na Java SE 21; produkcijsko okruženje nije potvrđeno.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori