CKTIS / Java
java.lang.Class — информация за типовете по време на изпълнение
Class<T> представя тип в изпълняваща се програма. С него могат да се проверяват и преобразуват обекти, както и да се разглеждат имена, декларации на членове, генерични супертипове и анотации. Този запис е за Java SE 21; средата за изпълнение на хранилището не удостоверява производствената среда.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);java.lang.Class описва клас, интерфейс, масив, примитивен тип или void, а не обикновен екземпляр на този тип. Литералът T.class обозначава конкретен разрешен тип, например String.class или int.class; не може да използва променлива на тип T, нито да има формата List<String>.class.
Class.getSimpleName връща простото име; за обикновен клас Class.getName връща двоичното му име: String спрямо java.lang.String. Class.isInstance проверява съвместимостта на обект и връща false за null. Class.cast връща съвместима препратка или хвърля ClassCastException; за null връща null.
Class.getDeclaredFields, Class.getDeclaredMethods и Class.getDeclaredConstructors изброяват собствените декларации, включително непубличните, но не и наследените; редът не е зададен. Class.getDeclaredField търси по име, Class.getDeclaredMethod — по име и точни типове на параметрите, а Class.getDeclaredConstructor — по точни типове на параметрите. Липсваща декларация води до NoSuchFieldException или NoSuchMethodException. Намирането на декларация не дава право тя да се използва: проверките за достъп и ограниченията на модулите продължават да важат.
Class.getGenericSuperclass връща прекия суперклас като Type, а за Object, интерфейси, примитивни типове и void връща null. Class.getGenericInterfaces връща преките суперинтерфейси като Type[]. И двата метода запазват генеричната информация от декларациите, но не възстановяват типовите аргументи на произволен обект, премахнати при изтриването на типовете. Class.getClassLoader връща зареждача; null може да означава зареждача за начално зареждане и винаги се връща за примитивни типове и void.
Class.getAnnotationsByType чете анотации, видими по време на изпълнение, и разгръща контейнерите на повторяеми анотации. Class.isAnnotationPresent проверява наличието, но не разгръща такива контейнери. И двата метода следват правилата на @Inherited за наследяване на анотации на класове, но не и за наследяване от интерфейси.
Примери
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());
}
}Резултат
String java.lang.String true Java false null true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.