CKTIS / Java
java.lang.Class — informação de tipos em tempo de execução
Class<T> representa um tipo num programa em execução. Permite verificar e converter objetos, além de inspecionar nomes, declarações de membros, supertipos genéricos e anotações. Esta entrada destina-se a Java SE 21; o runtime do repositório não atesta o runtime de produção.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);java.lang.Class descreve uma classe, uma interface, um array, um tipo primitivo ou void, não uma instância normal desse tipo. O literal T.class representa um tipo permitido específico, como String.class ou int.class; não pode usar uma variável de tipo T nem assumir a forma List<String>.class.
Class.getSimpleName devolve o nome simples; para uma classe normal, Class.getName devolve o nome binário: String versus java.lang.String. Class.isInstance verifica a compatibilidade de um objeto e devolve false para null. Class.cast devolve uma referência compatível ou lança ClassCastException; para null, devolve null.
Class.getDeclaredFields, Class.getDeclaredMethods e Class.getDeclaredConstructors enumeram as declarações próprias, incluindo as não públicas, mas excluem as herdadas; a ordem não é especificada. Class.getDeclaredField procura pelo nome, Class.getDeclaredMethod pelo nome e pelos tipos exatos dos parâmetros e Class.getDeclaredConstructor pelos tipos exatos dos parâmetros. A ausência de uma declaração provoca NoSuchFieldException ou NoSuchMethodException. Encontrar uma declaração não concede autorização para a usar: continuam a aplicar-se as verificações de acesso e as restrições dos módulos.
Class.getGenericSuperclass devolve a superclasse direta como Type, ou null para Object, interfaces, tipos primitivos e void. Class.getGenericInterfaces devolve as superinterfaces diretas como Type[]. Ambos os métodos mantêm a informação genérica das declarações, mas não recuperam os argumentos de tipo apagados de um objeto arbitrário. Class.getClassLoader devolve o carregador; null pode representar o carregador de arranque e é sempre devolvido para tipos primitivos e void.
Class.getAnnotationsByType lê as anotações visíveis em tempo de execução e expande os contentores de anotações repetíveis. Class.isAnnotationPresent verifica a presença, mas não expande esses contentores. Ambos seguem as regras de @Inherited para a herança de anotações de classes, não a herança de interfaces.
Exemplos
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());
}
}Resultado
String java.lang.String true Java false null true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.