CKTIS / Java
Constructor — prohlížení a volání konstruktorů pomocí reflexe
java.lang.reflect.Constructor<T> popisuje jeden konstruktor třídy T. Umožňuje zjistit typy parametrů a anotace a vytvářet objekty, přičemž je nutné respektovat řízení přístupu a hranice modulů v Java SE 21.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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> představuje jeden konstruktor třídy T, nikoli vytvořený objekt. Class.getConstructor(...) hledá veřejný konstruktor, zatímco Class.getDeclaredConstructor(...) najde také neveřejné konstruktory deklarované v dané třídě. Vyhledávání vyžaduje přesné typy parametrů: int.class a Integer.class nejsou zaměnitelné. Nalezení konstruktoru samo o sobě neopravňuje k jeho volání.
Constructor.getParameterTypes() vrací pole Class<?>[] v pořadí deklarace; konstruktor bez parametrů vrací prázdné pole. Mohou v něm být i implicitní parametry, například obklopující instance nestatické vnitřní třídy. Zděděná metoda Constructor.isAnnotationPresent(...) kontroluje anotaci konstruktoru, nikoli jeho parametrů. Anotace musí mít RetentionPolicy.RUNTIME, aby byla dostupná prostřednictvím reflexe.
Constructor.setAccessible(true) žádá o potlačení kontrol přístupu jazyka Java; deklaraci konstruktoru nemění. Hranice modulů nelze libovolně obejít: přístup k soukromému konstruktoru v jiném modulu vyžaduje otevření jeho balíčku volajícímu modulu. Odmítnutí může způsobit InaccessibleObjectException nebo SecurityException. setAccessible(false) kontroly obnoví, zatímco trySetAccessible() může vrátit false, pokud přístup nelze povolit. Dávej přednost přístupným veřejným API před spoléháním na soukromé konstruktory knihoven.
Constructor.newInstance(...) vytvoří a inicializuje objekt. Podporuje rozbalení argumentů a povolené rozšiřující konverze, nikoli však zužující konverze. Neplatné argumenty způsobí IllegalArgumentException, nepřístupný konstruktor IllegalAccessException a abstraktní třída InstantiationException. Výjimka vyvolaná konstruktorem je zabalena do InvocationTargetException; příčinu zjistíš pomocí getCause().
Příklad používá samostatnou nejvyšší třídu Item, takže Main nemá zvláštní přístup jako člen stejného hnízda k jejímu soukromému konstruktoru. Na classpath umožní volání setAccessible(true). Tento záznam se vztahuje k Java SE 21; produkční běhové prostředí nebylo potvrzeno.
Pří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ýsledek
[class java.lang.String] true Ada
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.