CKTIS / Java
Klassenreflexion: Namen, Felder, Konstruktoren und Annotationen
Untersuche in Java SE 21 die tatsächliche Klasse eines Objekts, lies ihren Namen und finde deklarierte Felder, Konstruktoren sowie direkte oder geerbte Annotationen.
Version: Java SE 21
Syntax
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);
}Verwende bei einem bekannten Typ ein Klassenliteral wie Item.class. Eine Typvariable wie T darf nicht in einem Klassenliteral stehen. Rufe Object.getClass() an einem Objekt auf, um seine tatsächliche Laufzeitklasse zu erhalten, unabhängig vom deklarierten Variablentyp. Class.getName() liefert für eine nicht versteckte Klasse oder Schnittstelle den Binärnamen, etwa Main$Item. Bei einem versteckten Typ enthält der Name / mit einem Suffix, bei einem Array ist er kodiert, etwa [I, und bei einem primitiven Typ oder void entspricht er dem Schlüsselwort.
Class.getDeclaredFields() liefert ein Field[] mit den in dieser Klasse oder Schnittstelle deklarierten Feldern aller Zugriffsstufen, ohne geerbte Felder. getFields() liefert nur öffentliche Felder, einschließlich geerbter. Für keines der Arrays ist eine Reihenfolge garantiert.
Class.getDeclaredConstructors() liefert ein Constructor<?>[] mit allen Konstruktoren der Klasse, auch privaten und implizit deklarierten. Die Reihenfolge ist nicht garantiert. Konstruktoren werden nicht vererbt. getConstructors() liefert nur öffentliche Konstruktoren. Für Schnittstellen, Arraytypen, primitive Typen und void liefern beide Methoden ein leeres Array.
Class.getDeclaredConstructor(...) liefert genau ein Constructor<T>-Objekt. Gib die exakten formalen Parametertypen in Deklarationsreihenfolge an: int.class ist nicht Integer.class, und ohne Argumente suchst du einen parameterlosen Konstruktor. Bei einer in einem nicht statischen Kontext deklarierten inneren Klasse steht der Typ der umschließenden Instanz zuerst. Ohne Treffer wird NoSuchMethodException ausgelöst. Das Auffinden allein erlaubt weder Feldzugriff noch Konstruktoraufruf; Modulgrenzen können das Ausschalten der Zugriffsprüfungen verhindern.
Class.isAnnotationPresent(A.class) prüft, ob die Deklarationsannotation A zur Laufzeit sichtbar (RetentionPolicy.RUNTIME) und direkt vorhanden ist oder, bei @Inherited, über die Kette der Oberklassen gefunden wird, nicht über Schnittstellen. Für ausschließlich direktes Vorhandensein verwende getDeclaredAnnotation(A.class) != null. In einem Container gespeicherte wiederholbare Annotationen liest du mit getAnnotationsByType(A.class).
Beispiele
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));
}
}Ergebnis
type: Main$Item fields: [label, size] constructors: 2 int constructor is private: true annotation present: true annotation declared: false
Die Variable ist als `Base` deklariert, das Objekt ist jedoch ein `Item`. Die sortierte Feldliste enthält das private Feld `size`, nicht aber das geerbte `inheritedId`. Das Programm findet den privaten Konstruktor mit `int`-Parameter, ohne ihn aufzurufen. `Audited` stammt von `Base` und ist nicht direkt auf `Item` deklariert.
Zugehörige Lektionen
- Java · Lektion 59 · Fortgeschritten · Version: 2