Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri