CKTIS / Java
Klassenreflectie: namen, velden, constructors en annotaties
Inspecteer in Java SE 21 de werkelijke klasse van een object, lees de naam, vind gedeclareerde velden en constructors en onderscheid directe van overgeërfde annotaties.
Versie: Java SE 21
Syntax
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);
}Gebruik een klasseliteral zoals Item.class als je het type kent. Een typevariabele zoals T mag niet in een klasseliteral staan. Roep Object.getClass() aan op een object om zijn werkelijke runtimeklasse te krijgen, ongeacht het gedeclareerde type van de variabele. Class.getName() geeft de binaire naam van een niet-verborgen klasse of interface, zoals Main$Item. Een verborgen type heeft / met een achtervoegsel in de naam, een array heeft een gecodeerde naam zoals [I, en een primitief type of void gebruikt het bijbehorende sleutelwoord.
Class.getDeclaredFields() geeft een Field[] met velden die in die klasse of interface zijn gedeclareerd, ongeacht het toegangsniveau en zonder overgeërfde velden. getFields() geeft alleen publieke velden, inclusief overgeërfde velden. Voor geen van beide arrays is een volgorde gegarandeerd.
Class.getDeclaredConstructors() geeft een Constructor<?>[] met alle constructors van die klasse, inclusief private en impliciet gedeclareerde constructors, zonder gegarandeerde volgorde. Constructors worden niet overgeërfd. getConstructors() geeft alleen publieke constructors. Beide methoden geven een lege array voor een interface, arraytype, primitief type of void.
Class.getDeclaredConstructor(...) geeft één Constructor<T> terug. Geef de exacte formele parametertypen op in declaratievolgorde: int.class is niet hetzelfde als Integer.class, en zonder argumenten zoek je een constructor zonder parameters. Geef bij een innerlijke klasse die in een niet-statische context is gedeclareerd eerst het type van de omsluitende instantie op. Zonder overeenkomst volgt NoSuchMethodException. Een lid vinden geeft geen toestemming om een veld te benaderen of een constructor aan te roepen; modulegrenzen kunnen verhinderen dat je toegangscontroles uitschakelt.
Class.isAnnotationPresent(A.class) controleert of de declaratieannotatie A tijdens uitvoering zichtbaar is (RetentionPolicy.RUNTIME) en direct aanwezig is, of bij @Inherited via de keten van superklassen wordt gevonden, niet via interfaces. Gebruik getDeclaredAnnotation(A.class) != null om alleen directe aanwezigheid te testen. Lees herhaalbare annotaties in een container met getAnnotationsByType(A.class).
Voorbeelden
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));
}
}Resultaat
type: Main$Item fields: [label, size] constructors: 2 int constructor is private: true annotation present: true annotation declared: false
De variabele is gedeclareerd als `Base`, maar het object is een `Item`. De gesorteerde veldlijst bevat het private veld `size`, maar niet het overgeërfde veld `inheritedId`. Het programma vindt de private constructor met een `int`-parameter zonder die aan te roepen. `Audited` komt van `Base` en is niet direct op `Item` gedeclareerd.
Gerelateerde lessen
- Java · Les 59 · Gevorderd · Versie: 2