Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

java.lang.Class — opis typu w czasie wykonania

Class<T> reprezentuje typ w działającym programie. Pozwala sprawdzać i rzutować obiekty oraz odczytywać nazwy, deklaracje składowych, generyczne nadtypy i adnotacje. Wpis dotyczy Java SE 21; środowisko repozytorium nie potwierdza środowiska produkcyjnego.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);

java.lang.Class opisuje klasę, interfejs, tablicę, typ prosty lub void, a nie zwykłą instancję tego typu. Literał T.class oznacza konkretny dozwolony typ, np. String.class lub int.class; nie działa dla zmiennej typu T ani List<String>.class.

Class.getSimpleName zwraca nazwę prostą, a Class.getName dla zwykłej klasy — nazwę binarną: String kontra java.lang.String. Class.isInstance sprawdza zgodność obiektu; dla null zwraca false. Class.cast zwraca zgodną referencję albo zgłasza ClassCastException; dla null zwraca null.

Class.getDeclaredFields, Class.getDeclaredMethods i Class.getDeclaredConstructors wyliczają własne deklaracje, także niepubliczne, bez odziedziczonych; kolejność nie jest gwarantowana. Class.getDeclaredField wyszukuje po nazwie, Class.getDeclaredMethod po nazwie i dokładnych typach parametrów, a Class.getDeclaredConstructor po dokładnych typach parametrów. Brak elementu powoduje NoSuchFieldException lub NoSuchMethodException. Znalezienie deklaracji nie daje prawa jej użycia: nadal obowiązują kontrole dostępu i ograniczenia modułów.

Class.getGenericSuperclass zwraca bezpośrednią nadklasę jako Type, a dla Object, interfejsów, typów prostych i void zwraca null. Class.getGenericInterfaces zwraca bezpośrednie nadinterfejsy jako Type[]. Obie metody zachowują informacje generyczne z deklaracji i nie odzyskują argumentów typu dowolnego obiektu po wymazaniu typów. Class.getClassLoader zwraca loader; null może oznaczać loader startowy, a dla typów prostych i void jest zwracane zawsze.

Class.getAnnotationsByType odczytuje adnotacje dostępne w czasie wykonania i rozwija kontener adnotacji powtarzalnych. Class.isAnnotationPresent sprawdza obecność, ale nie rozwija takiego kontenera. Obie metody uwzględniają dziedziczenie adnotacji klas zgodnie z @Inherited, nie dziedziczenie z interfejsów.

Przykłady

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

Wynik

String
java.lang.String
true
Java
false
null
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła