CKTIS / Java
java.lang.Class — informacije o tipu tijekom izvođenja
Class<T> predstavlja tip u programu koji se izvodi. Omogućuje provjeru i pretvorbu objekata te pregled naziva, deklaracija članova, generičkih nadtipova i anotacija. Ovaj se zapis odnosi na Java SE 21; okruženje repozitorija ne potvrđuje produkcijsko okruženje izvođenja.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);java.lang.Class opisuje klasu, sučelje, polje, primitivni tip ili void, a ne običnu instancu tog tipa. Literal T.class označava određeni dopušteni tip, primjerice String.class ili int.class; ne može upotrebljavati varijablu tipa T niti imati oblik List<String>.class.
Class.getSimpleName vraća jednostavan naziv; za običnu klasu Class.getName vraća njezin binarni naziv: String nasuprot java.lang.String. Class.isInstance provjerava kompatibilnost objekta i za null vraća false. Class.cast vraća kompatibilnu referencu ili baca ClassCastException; za null vraća null.
Class.getDeclaredFields, Class.getDeclaredMethods i Class.getDeclaredConstructors navode vlastite deklaracije, uključujući nejavne, ali ne i naslijeđene; redoslijed nije određen. Class.getDeclaredField traži po nazivu, Class.getDeclaredMethod po nazivu i točnim tipovima parametara, a Class.getDeclaredConstructor po točnim tipovima parametara. Ako deklaracija ne postoji, dolazi do NoSuchFieldException ili NoSuchMethodException. Pronalaženje deklaracije ne daje dopuštenje za njezinu upotrebu: i dalje vrijede provjere pristupa i ograničenja modula.
Class.getGenericSuperclass vraća izravnu nadklasu kao Type, a za Object, sučelja, primitivne tipove i void vraća null. Class.getGenericInterfaces vraća izravna nadsučelja kao Type[]. Obje metode čuvaju generičke informacije iz deklaracija, ali ne mogu obnoviti argumente tipa proizvoljnog objekta koji su uklonjeni brisanjem tipova. Class.getClassLoader vraća učitavač; null može označavati početni učitavač, a uvijek se vraća za primitivne tipove i void.
Class.getAnnotationsByType čita anotacije vidljive tijekom izvođenja i proširuje spremnike ponovljivih anotacija. Class.isAnnotationPresent provjerava prisutnost, ali ne proširuje takve spremnike. Obje metode slijede pravila @Inherited za nasljeđivanje anotacija klasa, a ne nasljeđivanje iz sučelja.
Primjeri
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());
}
}Rezultat
String java.lang.String true Java false null true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.