Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

java.lang.Class — informácie o typoch za behu

Class<T> predstavuje typ v bežiacom programe. Umožňuje overovať objekty a vykonávať pretypovanie, ako aj skúmať názvy, deklarácie členov, generické nadtypy a anotácie. Tento záznam sa vzťahuje na Java SE 21; behové prostredie repozitára nepotvrdzuje behové prostredie produkcie.

Verzia: 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 opisuje triedu, rozhranie, pole, primitívny typ alebo void, nie bežnú inštanciu tohto typu. Literál T.class označuje konkrétny povolený typ, napríklad String.class alebo int.class; nemožno použiť typovú premennú T ani zápis List<String>.class.

Class.getSimpleName vracia jednoduchý názov; pri bežnej triede vracia Class.getName binárny názov: String oproti java.lang.String. Class.isInstance overuje kompatibilitu objektu a pre null vracia false. Class.cast vráti kompatibilnú referenciu alebo vyvolá ClassCastException; pre null vráti null.

Class.getDeclaredFields, Class.getDeclaredMethods a Class.getDeclaredConstructors vypisujú vlastné deklarácie vrátane neverejných, nie však zdedené; poradie nie je určené. Class.getDeclaredField vyhľadáva podľa názvu, Class.getDeclaredMethod podľa názvu a presných typov parametrov a Class.getDeclaredConstructor podľa presných typov parametrov. Chýbajúce deklarácie spôsobia NoSuchFieldException alebo NoSuchMethodException. Nájdenie deklarácie samo osebe neoprávňuje na jej použitie: naďalej platia kontroly prístupu a obmedzenia modulov.

Class.getGenericSuperclass vracia priamu nadtriedu ako Type, pre Object, rozhrania, primitívne typy a void však vracia null. Class.getGenericInterfaces vracia priame nadrozhrania ako Type[]. Obe metódy zachovávajú generické informácie z deklarácií, ale neobnovia typové argumenty ľubovoľného objektu odstránené vymazaním typov. Class.getClassLoader vracia class loader; null môže označovať bootstrap loader a vždy sa vracia pre primitívne typy a void.

Class.getAnnotationsByType číta anotácie viditeľné za behu a rozbaľuje kontajnery opakovateľných anotácií. Class.isAnnotationPresent overuje prítomnosť anotácie, ale takéto kontajnery nerozbaľuje. Obe metódy dodržiavajú pravidlá @Inherited pre dedenie anotácií tried, nie dedenie z rozhraní.

Príklady

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());
    }
}

Výsledok

String
java.lang.String
true
Java
false
null
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje