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

CKTIS / Java

Reflexão de classes: nomes, campos, construtores e anotações

Inspeciona a classe real de um objeto em Java SE 21, lê o seu nome, encontra campos e construtores declarados e distingue anotações diretas de anotações herdadas.

Versão: Java SE 21

Sintaxe

static void inspect(Base value) throws NoSuchMethodException {
    Class<Item> type = Item.class;
    Class<?> runtimeType = value.getClass();
    String name = type.getName();
    Field[] fields = type.getDeclaredFields();
    java.lang.reflect.Constructor<?>[] constructors = type.getDeclaredConstructors();
    java.lang.reflect.Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
    boolean audited = type.isAnnotationPresent(Audited.class);
}

Quando conheces o tipo, usa um literal de classe como Item.class. Uma variável de tipo como T não pode ser usada num literal de classe. Chama Object.getClass() num objeto para obter a sua classe real em tempo de execução, independentemente do tipo declarado da variável. Class.getName() devolve o nome binário de uma classe ou interface não oculta, como Main$Item. O nome de um tipo oculto contém / seguido de um sufixo; o de um array é codificado, como [I; e o de um tipo primitivo ou de void é a palavra-chave correspondente.

Class.getDeclaredFields() devolve um Field[] com os campos declarados nessa classe ou interface, independentemente do nível de acesso, sem incluir campos herdados. getFields() devolve apenas campos públicos, incluindo os herdados. A ordem não é garantida em nenhum dos arrays.

Class.getDeclaredConstructors() devolve um Constructor<?>[] com todos os construtores da classe, incluindo os privados e os declarados implicitamente, sem ordem garantida. Os construtores não são herdados. getConstructors() devolve apenas os públicos. Ambos devolvem um array vazio para uma interface, um tipo array, um tipo primitivo ou void.

Class.getDeclaredConstructor(...) devolve um único Constructor<T>. Indica os tipos exatos dos parâmetros formais pela ordem da declaração: int.class não é Integer.class; sem argumentos, procuras um construtor sem parâmetros. Para uma classe interna declarada num contexto não estático, indica primeiro o tipo da instância envolvente. Se não houver correspondência, é lançada NoSuchMethodException. Encontrar um membro não dá autorização para aceder a um campo ou invocar um construtor; as fronteiras entre módulos podem impedir a desativação das verificações de acesso.

Class.isAnnotationPresent(A.class) verifica se a anotação de declaração A é visível em tempo de execução (RetentionPolicy.RUNTIME) e está presente diretamente ou, se A tiver @Inherited, através da cadeia de superclasses, não de interfaces. Para verificar apenas a presença direta, usa getDeclaredAnnotation(A.class) != null. Para ler anotações repetíveis guardadas num contentor, usa getAnnotationsByType(A.class).

Exemplos

import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.Arrays;

public class Main {
    @Inherited
    @Retention(RetentionPolicy.RUNTIME)
    @interface Audited {}

    @Audited
    static class Base {
        public int inheritedId;
    }

    static final class Item extends Base {
        private final int size;
        public String label = "item";

        public Item() { this(0); }
        private Item(int size) { this.size = size; }
    }

    public static void main(String[] args) throws NoSuchMethodException {
        Base value = new Item();
        Class<?> type = value.getClass();
        System.out.println("type: " + type.getName());
        System.out.println("fields: " + Arrays.stream(type.getDeclaredFields())
                .map(Field::getName).sorted().toList());
        System.out.println("constructors: " + type.getDeclaredConstructors().length);
        var constructor = type.getDeclaredConstructor(int.class);
        System.out.println("int constructor is private: " + Modifier.isPrivate(constructor.getModifiers()));
        System.out.println("annotation present: " + type.isAnnotationPresent(Audited.class));
        System.out.println("annotation declared: " + (type.getDeclaredAnnotation(Audited.class) != null));
    }
}

Resultado

type: Main$Item
fields: [label, size]
constructors: 2
int constructor is private: true
annotation present: true
annotation declared: false

A variável é declarada como `Base`, mas o objeto é um `Item`. A lista ordenada inclui o campo privado `size`, mas não o campo herdado `inheritedId`. O programa encontra o construtor privado com parâmetro `int` sem o invocar. `Audited` vem de `Base` e não é declarada diretamente em `Item`.

Lições relacionadas

  • Java · Lição 59 · Avançado · Versão: 2

Fontes