CKTIS / Java
java.lang.Class — informacije o tipih med izvajanjem
Class<T> predstavlja tip v delujočem programu. Omogoča preverjanje in pretvarjanje objektov ter pregled imen, deklaracij članov, generičnih nadtipov in anotacij. Ta zapis velja za Java SE 21; izvajalno okolje repozitorija ne potrjuje produkcijskega izvajalnega okolja.
Različica: 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 razred, vmesnik, polje, primitivni tip ali void, ne pa običajnega primerka tega tipa. Dobesedni zapis T.class označuje določen dovoljeni tip, na primer String.class ali int.class; uporabiti ne more spremenljivke tipa T ali zapisa List<String>.class.
Class.getSimpleName vrne preprosto ime; za običajen razred Class.getName vrne binarno ime: String v primerjavi z java.lang.String. Class.isInstance preveri združljivost objekta in za null vrne false. Class.cast vrne združljivo referenco ali sproži ClassCastException; za null vrne null.
Class.getDeclaredFields, Class.getDeclaredMethods in Class.getDeclaredConstructors naštejejo lastne deklaracije, tudi nejavne, ne pa podedovanih; vrstni red ni določen. Class.getDeclaredField išče po imenu, Class.getDeclaredMethod po imenu in natančnih tipih parametrov, Class.getDeclaredConstructor pa po natančnih tipih parametrov. Če deklaracija ne obstaja, pride do NoSuchFieldException ali NoSuchMethodException. Najdba deklaracije še ne pomeni dovoljenja za njeno uporabo: še vedno veljajo preverjanja dostopa in omejitve modulov.
Class.getGenericSuperclass vrne neposredni nadrazred kot Type, za Object, vmesnike, primitivne tipe in void pa vrne null. Class.getGenericInterfaces vrne neposredne nadvmesnike kot Type[]. Obe metodi ohranita generične informacije iz deklaracij, ne moreta pa obnoviti tipnih argumentov poljubnega objekta, ki so bili odstranjeni z izbrisom tipov. Class.getClassLoader vrne nalagalnik; null lahko pomeni zagonski nalagalnik, za primitivne tipe in void pa je vedno vrnjen.
Class.getAnnotationsByType prebere anotacije, vidne med izvajanjem, in razširi vsebnike ponovljivih anotacij. Class.isAnnotationPresent preveri prisotnost anotacije, vendar takih vsebnikov ne razširi. Obe metodi upoštevata pravila @Inherited za dedovanje anotacij razredov, ne pa dedovanja iz vmesnikov.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.