CKTIS / Java
java.lang.Class — informace o typech za běhu
Class<T> představuje typ v běžícím programu. Umožňuje ověřovat objekty a provádět přetypování a také zkoumat názvy, deklarace členů, generické nadtypy a anotace. Tento záznam se vztahuje k Java SE 21; běhové prostředí repozitáře nepotvrzuje běhové prostředí produkce.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);java.lang.Class popisuje třídu, rozhraní, pole, primitivní typ nebo void, nikoli běžnou instanci tohoto typu. Literál T.class označuje konkrétní povolený typ, například String.class nebo int.class; nelze použít typovou proměnnou T ani zápis List<String>.class.
Class.getSimpleName vrací jednoduchý název; u běžné třídy vrací Class.getName binární název: String oproti java.lang.String. Class.isInstance ověřuje kompatibilitu objektu a pro null vrací false. Class.cast vrátí kompatibilní referenci, nebo vyvolá ClassCastException; pro null vrací null.
Class.getDeclaredFields, Class.getDeclaredMethods a Class.getDeclaredConstructors vypisují vlastní deklarace včetně neveřejných, nikoli zděděné; pořadí není určeno. Class.getDeclaredField hledá podle názvu, Class.getDeclaredMethod podle názvu a přesných typů parametrů a Class.getDeclaredConstructor podle přesných typů parametrů. Chybějící deklarace způsobí NoSuchFieldException nebo NoSuchMethodException. Nalezení deklarace samo o sobě neopravňuje k jejímu použití: stále platí kontroly přístupu a omezení modulů.
Class.getGenericSuperclass vrací přímou nadtřídu jako Type, pro Object, rozhraní, primitivní typy a void však vrací null. Class.getGenericInterfaces vrací přímá nadrozhraní jako Type[]. Obě metody zachovávají generické informace z deklarací, ale neobnoví typové argumenty libovolného objektu, které byly odstraněny v důsledku type erasure. Class.getClassLoader vrací class loader; null může označovat bootstrap loader a vždy se vrací pro primitivní typy a void.
Class.getAnnotationsByType čte anotace viditelné za běhu a rozbaluje kontejnery opakovatelných anotací. Class.isAnnotationPresent ověřuje přítomnost anotace, ale takové kontejnery nerozbaluje. Obě metody dodržují pravidla @Inherited pro dědění anotací tříd, nikoli dědění z rozhraní.
Pří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ýsledek
String java.lang.String true Java false null true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.