CKTIS / Java
Refleksja klas: nazwy, pola, konstruktory i adnotacje
Sprawdź rzeczywistą klasę obiektu w Java SE 21, odczytaj jej nazwę, znajdź zadeklarowane pola i konstruktory oraz odróżnij adnotację bezpośrednią od odziedziczonej.
Wersja: Java SE 21
Składnia
static void inspect(Base value) throws NoSuchMethodException {
Class<Item> type = Item.class;
Class<?> runtimeType = value.getClass();
String name = type.getName();
Field[] fields = type.getDeclaredFields();
java.lang.reflect.Constructor<?>[] constructors = type.getDeclaredConstructors();
java.lang.reflect.Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
boolean audited = type.isAnnotationPresent(Audited.class);
}Gdy znasz typ, użyj literału klasy, np. Item.class. Zmiennej typu T nie można użyć w literale klasy. Wywołaj Object.getClass() na obiekcie, by uzyskać jego rzeczywistą klasę, niezależnie od typu zmiennej. Class.getName() zwraca nazwę binarną klasy lub interfejsu, o ile typ nie jest ukryty (np. Main$Item). Dla typu ukrytego nazwa zawiera / z przyrostkiem, dla tablicy ma postać kodowaną, np. [I, a dla typu prostego lub void jest słowem kluczowym.
Class.getDeclaredFields() zwraca Field[] z polami zadeklarowanymi w tej klasie lub interfejsie, niezależnie od modyfikatora dostępu, bez pól odziedziczonych. getFields() zwraca tylko pola publiczne, w tym odziedziczone. Kolejność w obu tablicach nie jest gwarantowana.
Class.getDeclaredConstructors() zwraca Constructor<?>[] ze wszystkimi konstruktorami tej klasy, również prywatnymi i deklarowanymi niejawnie, bez gwarancji kolejności. Konstruktory nie są dziedziczone. getConstructors() zwraca tylko publiczne. Dla interfejsu, tablicy, typu prostego i void obie metody zwracają pustą tablicę.
Class.getDeclaredConstructor(...) zwraca jeden Constructor<T>. Podaj dokładne typy parametrów formalnych w kolejności deklaracji: int.class to nie Integer.class; brak argumentów oznacza konstruktor bezparametrowy. Dla klasy wewnętrznej zadeklarowanej w kontekście niestatycznym najpierw podaj typ instancji otaczającej. Brak dopasowania oznacza NoSuchMethodException. Znalezienie elementu nie daje prawa dostępu do pola ani wywołania konstruktora; granice modułów mogą uniemożliwić pominięcie kontroli dostępu.
Class.isAnnotationPresent(A.class) sprawdza, czy adnotacja deklaracji A jest widoczna w czasie wykonania (RetentionPolicy.RUNTIME) i obecna bezpośrednio lub, jeśli ma @Inherited, przez łańcuch nadklas, a nie interfejsów. Do sprawdzenia tylko bezpośredniej obecności użyj getDeclaredAnnotation(A.class) != null. Aby odczytać adnotacje powtarzalne zapisane w kontenerze, użyj getAnnotationsByType(A.class).
Przykłady
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.Arrays;
public class Main {
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@interface Audited {}
@Audited
static class Base {
public int inheritedId;
}
static final class Item extends Base {
private final int size;
public String label = "item";
public Item() { this(0); }
private Item(int size) { this.size = size; }
}
public static void main(String[] args) throws NoSuchMethodException {
Base value = new Item();
Class<?> type = value.getClass();
System.out.println("type: " + type.getName());
System.out.println("fields: " + Arrays.stream(type.getDeclaredFields())
.map(Field::getName).sorted().toList());
System.out.println("constructors: " + type.getDeclaredConstructors().length);
var constructor = type.getDeclaredConstructor(int.class);
System.out.println("int constructor is private: " + Modifier.isPrivate(constructor.getModifiers()));
System.out.println("annotation present: " + type.isAnnotationPresent(Audited.class));
System.out.println("annotation declared: " + (type.getDeclaredAnnotation(Audited.class) != null));
}
}Wynik
type: Main$Item fields: [label, size] constructors: 2 int constructor is private: true annotation present: true annotation declared: false
Zmienna ma typ `Base`, lecz obiekt jest typu `Item`. Posortowana lista zawiera prywatne `size`, ale nie odziedziczone `inheritedId`. Program znajduje prywatny konstruktor z parametrem `int`, ale go nie wywołuje. `Audited` pochodzi z `Base` i nie jest zadeklarowana bezpośrednio na `Item`.
Powiązane lekcje
- Java · Lekcja 59 · Zaawansowany · Wersja: 2