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.