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.