CKTIS / Java
Reflexión de clases: nombres, campos, constructores y anotaciones
Inspecciona la clase real de un objeto en Java SE 21, consulta su nombre, localiza los campos y constructores declarados y distingue las anotaciones directas de las heredadas.
Versión: Java SE 21
Sintaxis
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);
}Si conoces el tipo, usa un literal de clase como Item.class. Una variable de tipo como T no puede usarse en un literal de clase. Llama a Object.getClass() sobre un objeto para obtener su clase real en tiempo de ejecución, independientemente del tipo declarado de la variable. Class.getName() devuelve el nombre binario de una clase o interfaz no oculta, como Main$Item. Un tipo oculto lleva / seguido de un sufijo en el nombre; un array tiene un nombre codificado como [I; un tipo primitivo o void usa su palabra clave.
Class.getDeclaredFields() devuelve un Field[] con los campos declarados en esa clase o interfaz, de cualquier nivel de acceso, sin los heredados. getFields() solo devuelve campos públicos, incluidos los heredados. Ninguno de los dos arrays tiene un orden garantizado.
Class.getDeclaredConstructors() devuelve un Constructor<?>[] con todos los constructores de la clase, incluidos los privados y los declarados implícitamente, sin garantizar el orden. Los constructores no se heredan. getConstructors() solo devuelve los públicos. Ambas llamadas devuelven un array vacío para una interfaz, un tipo array, un tipo primitivo o void.
Class.getDeclaredConstructor(...) devuelve un solo Constructor<T>. Pasa los tipos exactos de los parámetros formales en el orden de declaración: int.class no es Integer.class; sin argumentos, se busca un constructor sin parámetros. Para una clase interna declarada en un contexto no estático, pasa primero el tipo de la instancia envolvente. Si no hay coincidencia, se lanza NoSuchMethodException. Encontrar un miembro no da permiso para acceder a un campo ni para invocar un constructor; los límites de los módulos pueden impedir la supresión de las comprobaciones de acceso.
Class.isAnnotationPresent(A.class) comprueba si la anotación de declaración A es visible en tiempo de ejecución (RetentionPolicy.RUNTIME) y está presente directamente o, si A tiene @Inherited, a través de la cadena de superclases, no de interfaces. Para comprobar solo la presencia directa, usa getDeclaredAnnotation(A.class) != null. Para leer anotaciones repetibles guardadas en un contenedor, usa getAnnotationsByType(A.class).
Ejemplos
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
La variable se declara como `Base`, pero el objeto es un `Item`. La lista ordenada incluye el campo privado `size`, pero no el campo heredado `inheritedId`. El programa encuentra el constructor privado con parámetro `int` sin invocarlo. `Audited` viene de `Base` y no se declara directamente en `Item`.
Lecciones relacionadas
- Java · Lección 59 · Avanzado · Versión: 2