Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje