CKTIS / Java
java.lang.Class — runtime-type-informatie
Class<T> vertegenwoordigt een type in een actief programma. Je kunt er objecten mee controleren en casten, en namen, memberdeclaraties, generieke supertypes en annotaties mee bekijken. Dit artikel is gericht op Java SE 21; de runtime van de repository garandeert niet dat van productie.
Versie: 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 beschrijft een klasse, interface, array, primitief type of void, niet een gewone instantie van dat type. Het literal T.class duidt een specifiek toegestaan type aan, zoals String.class of int.class; een typevariabele T kan niet worden gebruikt en List<String>.class is evenmin mogelijk.
Class.getSimpleName geeft de eenvoudige naam terug; voor een gewone klasse geeft Class.getName de binaire naam terug: String tegenover java.lang.String. Class.isInstance controleert of een object compatibel is en geeft false terug voor null. Class.cast geeft een compatibele referentie terug of werpt ClassCastException; voor null geeft de methode null terug.
Class.getDeclaredFields, Class.getDeclaredMethods en Class.getDeclaredConstructors sommen de eigen declaraties op, ook niet-openbare, maar niet geërfde; de volgorde is niet gespecificeerd. Class.getDeclaredField zoekt op naam, Class.getDeclaredMethod op naam en exacte parametertypen, en Class.getDeclaredConstructor op exacte parametertypen. Ontbrekende declaraties veroorzaken NoSuchFieldException of NoSuchMethodException. Een declaratie vinden geeft geen toestemming om die te gebruiken: toegangscontroles en modulebeperkingen blijven gelden.
Class.getGenericSuperclass geeft de directe superclass terug als Type, of null voor Object, interfaces, primitieve typen en void. Class.getGenericInterfaces geeft de directe superinterfaces terug als Type[]. Beide methoden behouden generieke informatie uit de declaraties, maar halen geen typeargumenten van een willekeurig object terug die door type-uitwissing verloren zijn gegaan. Class.getClassLoader geeft de loader terug; null kan de bootstraploader aanduiden en wordt altijd teruggegeven voor primitieve typen en void.
Class.getAnnotationsByType leest runtime-zichtbare annotaties en vouwt containers van herhaalbare annotaties uit. Class.isAnnotationPresent controleert of een annotatie aanwezig is, maar vouwt zulke containers niet uit. Beide methoden volgen de regels van @Inherited voor overerving van klasse-annotaties, niet voor overerving vanuit interfaces.
Voorbeelden
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());
}
}Resultaat
String java.lang.String true Java false null true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.