CKTIS / Java
Java-Reflection: Typnamen, deklarierte Member und Konstruktoren
Lies den Namen eines Typs aus, suche direkt darin deklarierte Felder und Methoden und erzeuge ein Objekt mit einem ausgewählten Konstruktor. Suche und Zugriff sind getrennte Schritte.
Version: Java SE 21
Syntax
String Class.getName()
String Class.getSimpleName()
Field[] Class.getDeclaredFields()
Field Class.getDeclaredField(String name) throws NoSuchFieldException
Method[] Class.getDeclaredMethods()
Method Class.getDeclaredMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException
Constructor<T> Class<T>.getDeclaredConstructor(Class<?>... parameterTypes) throws NoSuchMethodException
T Constructor<T>.newInstance(Object... initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetExceptionIn Java SE 21 liefert Class.getName() den Binärnamen einer nicht verborgenen Klasse oder Schnittstelle, etwa demo.Main$Item. Verborgene Typen haben einen speziellen Namen mit einem Suffix nach /; Arrays verwenden eine Kodierung wie [I; primitive Typen und void erscheinen als Schlüsselwort. Class.getSimpleName() liefert den einfachen Namen aus dem Quellcode, etwa Item, bei anonymen Klassen die leere Zeichenfolge und bei Arrays den einfachen Komponentennamen mit angehängtem [].
getDeclaredFields() und getDeclaredMethods() liefern Field[] beziehungsweise Method[]. Sie enthalten direkt im Typ deklarierte Member unabhängig von der Sichtbarkeit, auch private, aber keine geerbten Member. getFields() und getMethods() liefern dagegen nur öffentliche Member und können geerbte aufnehmen. Die Reihenfolge ist nicht festgelegt; die Methodenliste kann Brückenmethoden oder andere synthetische Methoden enthalten.
getDeclaredField(name) sucht nach dem Feldnamen und wirft bei fehlendem Treffer NoSuchFieldException. getDeclaredMethod(name, parameterTypes...) verlangt den Namen und die exakten formalen Parametertypen in Deklarationsreihenfolge. getDeclaredConstructor(parameterTypes...) gleicht die Parameter ebenso ab und liefert auch für einen nicht öffentlichen Konstruktor ein Constructor<T>-Objekt. Fehlt die Methode oder der Konstruktor, folgt NoSuchMethodException. Bei der Suche gibt es weder Boxing noch Übereinstimmung über Untertypen: int.class und Integer.class sind verschieden. Für String... suche mit String[].class; ohne Parameter gib keine Typen an. Der Rückgabetyp ist kein Suchargument: Passen mehrere Methoden, gewinnt diejenige mit einem spezifischeren Rückgabetyp als alle anderen, sofern es sie gibt; sonst ist die Wahl beliebig.
Ein Treffer gibt noch kein Zugriffsrecht. Um bei einem privaten Member in einem anderen Modul Zugriffsprüfungen zu unterdrücken, muss das Paket für das aufrufende Modul geöffnet sein. Verhindern Zugriffsregeln das Unterdrücken, gibt trySetAccessible() false zurück, während setAccessible(true) eine InaccessibleObjectException wirft. In Java SE 21 können beide Methoden eine SecurityException auslösen, wenn ein installierter Security Manager die Berechtigung ReflectPermission("suppressAccessChecks") verweigert.
Bei der Konstruktorsuche geben Class-Objekte die Parametertypen an. Beim Aufruf des ausgewählten Konstruktors nimmt Constructor.newInstance die tatsächlichen Argumentwerte entgegen. Dazu kann auch ein Class-Objekt gehören, wenn es zum jeweiligen Parametertyp passt. Zulässig sind etwa Unboxing und erlaubte erweiternde Konvertierungen. Bei einer nichtstatischen Memberklasse steht bei der Suche der Typ der umschließenden Klasse und beim Aufruf ihre Instanz an erster Stelle. Sind die Prüfungen erfolgreich, wird die Klasse bei Bedarf vor der Objekterzeugung initialisiert. Fehlender Zugriff führt zu IllegalAccessException, eine falsche Argumentzahl, inkompatible Typen oder ein Enum-Konstruktor zu IllegalArgumentException und eine abstrakte Klasse zu InstantiationException. Eine Ausnahme aus dem Konstruktor steckt in InvocationTargetException; getCause() liefert die Ursache. Die Klasseninitialisierung kann separat mit ExceptionInInitializerError fehlschlagen. Nicht zu verwechseln mit Class.newInstance(): Das ruft nur einen parameterlosen Konstruktor auf und ist seit Java 9 veraltet.
Beispiele
package demo;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.util.Arrays;
public class Main {
static class Base {
public int inherited;
public void reset() {}
}
static final class Item extends Base {
private final int count;
private Item(int count) {
this.count = count;
}
private String label(int offset) { return "count=" + (count + offset); }
public String label(String prefix) { return prefix + count; }
}
public static void main(String[] args) throws ReflectiveOperationException {
Class<Item> type = Item.class;
System.out.println(type.getName());
System.out.println(type.getSimpleName());
System.out.println(Arrays.stream(type.getDeclaredFields())
.map(Field::getName).sorted().toList());
System.out.println(Arrays.stream(type.getDeclaredMethods())
.map(m -> m.getName() + "(" + m.getParameterTypes()[0].getSimpleName() + ")")
.sorted().toList());
System.out.println(type.getDeclaredField("count").getType().getName());
var method = type.getDeclaredMethod("label", int.class);
Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
Item item = constructor.newInstance(7);
System.out.println(method.invoke(item, 0));
}
}Ergebnis
demo.Main$Item Item [count] [label(String), label(int)] int count=7
Die Listen werden vor der Ausgabe sortiert. `inherited` und `reset` stammen aus `Base` und fehlen deshalb in den Listen für `Item`. `int.class` wählt `label(int)` aus, und `7` geht an den Konstruktor. `Main` und `Item` liegen im selben Klassennest; die Zugriffsprüfungen für den privaten Konstruktor und die private Methode müssen nicht unterdrückt werden.
Zugehörige Lektionen
- Java · Lektion 54 · Fortgeschritten · Version: 2