Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

java.lang.Class — información de tipos en tiempo de ejecución

Class<T> representa un tipo en un programa en ejecución. Permite comprobar y convertir objetos, además de inspeccionar nombres, declaraciones de miembros, supertipos genéricos y anotaciones. Esta entrada está dirigida a Java SE 21; el entorno de ejecución del repositorio no acredita el entorno de producción.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

Class<String> type = String.class;
boolean matches = type.isInstance(value);
String text = type.cast(value);

java.lang.Class describe una clase, una interfaz, un array, un tipo primitivo o void, no una instancia ordinaria de ese tipo. El literal T.class representa un tipo permitido concreto, como String.class o int.class; no puede usar una variable de tipo T ni tener la forma List<String>.class.

Class.getSimpleName devuelve el nombre simple; para una clase ordinaria, Class.getName devuelve su nombre binario: String frente a java.lang.String. Class.isInstance comprueba la compatibilidad de un objeto y devuelve false para null. Class.cast devuelve una referencia compatible o lanza ClassCastException; para null, devuelve null.

Class.getDeclaredFields, Class.getDeclaredMethods y Class.getDeclaredConstructors enumeran las declaraciones propias, incluidas las no públicas, pero excluyen las heredadas; el orden no está especificado. Class.getDeclaredField busca por nombre, Class.getDeclaredMethod por nombre y tipos exactos de parámetros, y Class.getDeclaredConstructor por tipos exactos de parámetros. Si falta una declaración, se produce NoSuchFieldException o NoSuchMethodException. Encontrar una declaración no concede permiso para usarla: siguen aplicándose los controles de acceso y las restricciones de módulos.

Class.getGenericSuperclass devuelve la superclase directa como Type, o null para Object, las interfaces, los tipos primitivos y void. Class.getGenericInterfaces devuelve las superinterfaces directas como Type[]. Ambos métodos conservan la información genérica de las declaraciones, pero no recuperan los argumentos de tipo borrados de un objeto cualquiera. Class.getClassLoader devuelve el cargador; null puede representar el cargador de arranque y siempre se devuelve para los tipos primitivos y void.

Class.getAnnotationsByType lee las anotaciones visibles en tiempo de ejecución y expande los contenedores de anotaciones repetibles. Class.isAnnotationPresent comprueba si hay una anotación, pero no expande esos contenedores. Ambos métodos siguen las reglas de @Inherited para la herencia de anotaciones de clase, no la herencia desde interfaces.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes