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.