CKTIS / Java
java.lang.Class — Typinformationen zur Laufzeit
Class<T> repräsentiert einen Typ in einem laufenden Programm. Damit lassen sich Objekte prüfen und umwandeln sowie Namen, Memberdeklarationen, generische Supertypen und Annotationen untersuchen. Dieser Eintrag bezieht sich auf Java SE 21; die Repository-Laufzeit bestätigt nicht die Produktionslaufzeit.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);java.lang.Class beschreibt eine Klasse, ein Interface, ein Array, einen primitiven Typ oder void, nicht eine gewöhnliche Instanz dieses Typs. Das Literal T.class bezeichnet einen bestimmten zulässigen Typ, etwa String.class oder int.class; eine Typvariable T ist dafür nicht möglich, ebenso wenig List<String>.class.
Class.getSimpleName liefert den einfachen Namen; für eine gewöhnliche Klasse liefert Class.getName den Binärnamen: String gegenüber java.lang.String. Class.isInstance prüft die Typverträglichkeit eines Objekts und liefert für null den Wert false. Class.cast liefert eine kompatible Referenz oder löst ClassCastException aus; für null liefert die Methode null.
Class.getDeclaredFields, Class.getDeclaredMethods und Class.getDeclaredConstructors führen die eigenen Deklarationen auf, auch nichtöffentliche, jedoch keine geerbten; die Reihenfolge ist nicht festgelegt. Class.getDeclaredField sucht nach Namen, Class.getDeclaredMethod nach Namen und exakten Parametertypen und Class.getDeclaredConstructor nach exakten Parametertypen. Fehlende Deklarationen führen zu NoSuchFieldException oder NoSuchMethodException. Eine gefundene Deklaration darf deshalb noch nicht verwendet werden: Zugriffsprüfungen und Moduleinschränkungen gelten weiterhin.
Class.getGenericSuperclass liefert die direkte Oberklasse als Type, für Object, Interfaces, primitive Typen und void jedoch null. Class.getGenericInterfaces liefert die direkten Oberinterfaces als Type[]. Beide Methoden bewahren generische Informationen aus den Deklarationen, können aber die durch Typlöschung entfernten Typargumente eines beliebigen Objekts nicht wiederherstellen. Class.getClassLoader liefert den Class Loader; null kann den Bootstrap-Class-Loader bezeichnen und wird für primitive Typen und void immer zurückgegeben.
Class.getAnnotationsByType liest zur Laufzeit sichtbare Annotationen und entfaltet Container wiederholbarer Annotationen. Class.isAnnotationPresent prüft das Vorhandensein, entfaltet solche Container aber nicht. Beide Methoden beachten @Inherited für die Vererbung von Klassenannotationen, nicht jedoch eine Vererbung von Interfaces.
Beispiele
public class Main {
public static void main(String[] args) throws ReflectiveOperationException {
Class<String> type = String.class;
Object value = "Java";
System.out.println(type.getSimpleName());
System.out.println(type.getName());
System.out.println(type.isInstance(value));
System.out.println(type.cast(value));
System.out.println(type.isInstance(null));
System.out.println(type.cast(null));
System.out.println(type.getDeclaredConstructor().newInstance().isEmpty());
}
}Ergebnis
String java.lang.String true Java false null true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.