CKTIS / Java
Constructor — inspekcja i wywoływanie konstruktorów przez refleksję
java.lang.reflect.Constructor<T> opisuje pojedynczy konstruktor klasy T. Umożliwia odczyt typów parametrów i adnotacji oraz tworzenie obiektów, z uwzględnieniem kontroli dostępu i granic modułów Java SE 21.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
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> reprezentuje jeden konstruktor klasy T, a nie utworzony obiekt. Class.getConstructor(...) wyszukuje konstruktor publiczny, natomiast Class.getDeclaredConstructor(...) także niepubliczny, zadeklarowany w danej klasie. Wyszukiwanie wymaga dokładnych typów parametrów: int.class i Integer.class nie są zamienne. Samo znalezienie konstruktora nie daje prawa do jego wywołania.
Constructor.getParameterTypes() zwraca tablicę Class<?>[] w kolejności deklaracji; dla konstruktora bez parametrów jest ona pusta. Może uwzględniać parametry niejawne, np. instancję otaczającą dla niestatycznej klasy wewnętrznej. Odziedziczona metoda Constructor.isAnnotationPresent(...) sprawdza adnotację konstruktora, nie jego parametrów. Adnotacja musi mieć RetentionPolicy.RUNTIME, aby była dostępna przez refleksję.
Constructor.setAccessible(true) żąda pominięcia kontroli dostępu języka Java; nie zmienia deklaracji konstruktora. Nie omija dowolnie granic modułów: dostęp do prywatnego konstruktora w innym module wymaga otwarcia pakietu dla modułu wywołującego. Odmowa może oznaczać InaccessibleObjectException lub SecurityException. setAccessible(false) przywraca kontrolę, a trySetAccessible() pozwala otrzymać false, gdy nie można włączyć dostępu. Preferuj dostępne publiczne API zamiast polegania na prywatnych konstruktorach bibliotek.
Constructor.newInstance(...) tworzy i inicjalizuje obiekt. Obsługuje rozpakowanie argumentów i dozwolone konwersje rozszerzające, ale nie zawężające. Błędne argumenty powodują IllegalArgumentException, brak dostępu — IllegalAccessException, a klasa abstrakcyjna — InstantiationException. Wyjątek konstruktora jest opakowany w InvocationTargetException; przyczynę odczytasz przez getCause().
Przykład używa osobnej klasy najwyższego poziomu Item, więc Main nie ma specjalnego dostępu do jej prywatnego konstruktora jako współdzielący gniazdo. Na ścieżce klas setAccessible(true) umożliwia wywołanie. Zakres opisu to Java SE 21; środowisko produkcyjne nie zostało potwierdzone.
Przykłady
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);
}
}Wynik
[class java.lang.String] true Ada
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.