Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes