CKTIS / Java
Reflectie in Java: typenamen, gedeclareerde leden en constructors
Lees de naam van een type, zoek velden en methoden die het zelf declareert en maak met een gekozen constructor een object. Houd opzoeken en toegang verlenen uit elkaar.
Versie: Java SE 21
Syntax
String Class.getName()
String Class.getSimpleName()
Field[] Class.getDeclaredFields()
Field Class.getDeclaredField(String name) throws NoSuchFieldException
Method[] Class.getDeclaredMethods()
Method Class.getDeclaredMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException
Constructor<T> Class<T>.getDeclaredConstructor(Class<?>... parameterTypes) throws NoSuchMethodException
T Constructor<T>.newInstance(Object... initargs) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetExceptionIn Java SE 21 geeft Class.getName() de binaire naam van een niet-verborgen klasse of interface, zoals demo.Main$Item. Een verborgen type heeft een speciale naam met een achtervoegsel na /; een array gebruikt een codering zoals [I; primitieve typen en void gebruiken hun sleutelwoord. Class.getSimpleName() geeft de eenvoudige naam uit de broncode, zoals Item, een lege tekenreeks voor een anonieme klasse en voor een array de eenvoudige componentnaam met [] erachter.
getDeclaredFields() en getDeclaredMethods() leveren respectievelijk Field[] en Method[]. Ze bevatten leden die rechtstreeks in het type zijn gedeclareerd, ongeacht zichtbaarheid, dus ook private, maar geen geërfde leden. getFields() en getMethods() geven alleen openbare leden en kunnen geërfde leden bevatten. De volgorde ligt niet vast; de methodenlijst kan brugmethoden of andere synthetische methoden bevatten.
getDeclaredField(name) zoekt een veld op naam en gooit NoSuchFieldException als het ontbreekt. getDeclaredMethod(name, parameterTypes...) vergelijkt de naam en de exacte formele parametertypen in declaratievolgorde. getDeclaredConstructor(parameterTypes...) vergelijkt de parameters op dezelfde manier en levert een Constructor<T>, ook voor een niet-openbare constructor. Een ontbrekende methode of constructor leidt tot NoSuchMethodException. Bij het zoeken vindt geen boxing plaats en een subtype geldt niet als overeenkomst: int.class en Integer.class verschillen. Zoek voor String... met String[].class; geef voor een signatuur zonder parameters geen typen op. Het retourtype is geen zoekargument: bij meerdere treffers wint de methode met een specifieker retourtype dan alle andere, als die bestaat; anders is de keuze willekeurig.
Een gevonden lid mag je niet automatisch gebruiken. Om toegangscontroles voor een privélid uit een andere module te onderdrukken, moet het pakket openstaan voor de aanroepende module. Als toegangsbeperkingen dat verhinderen, geeft trySetAccessible() false terug, terwijl setAccessible(true) InaccessibleObjectException gooit. In Java SE 21 kunnen beide methoden SecurityException gooien als een geïnstalleerde securitymanager de machtiging ReflectPermission("suppressAccessChecks") weigert.
Bij het opzoeken van een constructor geven Class-objecten de parametertypen aan. Om de gekozen constructor aan te roepen, geef je aan Constructor.newInstance de werkelijke argumentwaarden door. Een Class-object is daarbij een geldige waarde als het past bij het bijbehorende parametertype. Onder meer unboxing en toegestane verbredende conversies zijn mogelijk. Geef voor een niet-statische lidklasse bij het zoeken eerst het type van de omsluitende klasse op en bij het aanroepen eerst de omsluitende instantie. Als de controles slagen, wordt de klasse zo nodig geïnitialiseerd voordat het object wordt gemaakt. Ontbrekende toegang leidt tot IllegalAccessException; een verkeerd aantal argumenten, incompatibele typen of een enum-constructor tot IllegalArgumentException; een abstracte klasse tot InstantiationException. Een uitzondering uit de constructor wordt verpakt in InvocationTargetException; bekijk de oorzaak met getCause(). Klasse-initialisatie kan afzonderlijk mislukken met ExceptionInInitializerError. Verwar dit niet met Class.newInstance(), dat alleen een constructor zonder argumenten aanroept en sinds Java 9 verouderd is.
Voorbeelden
package demo;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.util.Arrays;
public class Main {
static class Base {
public int inherited;
public void reset() {}
}
static final class Item extends Base {
private final int count;
private Item(int count) {
this.count = count;
}
private String label(int offset) { return "count=" + (count + offset); }
public String label(String prefix) { return prefix + count; }
}
public static void main(String[] args) throws ReflectiveOperationException {
Class<Item> type = Item.class;
System.out.println(type.getName());
System.out.println(type.getSimpleName());
System.out.println(Arrays.stream(type.getDeclaredFields())
.map(Field::getName).sorted().toList());
System.out.println(Arrays.stream(type.getDeclaredMethods())
.map(m -> m.getName() + "(" + m.getParameterTypes()[0].getSimpleName() + ")")
.sorted().toList());
System.out.println(type.getDeclaredField("count").getType().getName());
var method = type.getDeclaredMethod("label", int.class);
Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
Item item = constructor.newInstance(7);
System.out.println(method.invoke(item, 0));
}
}Resultaat
demo.Main$Item Item [count] [label(String), label(int)] int count=7
De lijsten worden vóór het afdrukken gesorteerd. `inherited` en `reset` komen uit `Base` en staan dus niet in de lijsten van `Item`. `int.class` kiest `label(int)` en `7` gaat naar de constructor. `Main` en `Item` behoren tot hetzelfde klassennest, dus toegangscontroles voor de privéconstructor en privémethode hoeven niet te worden onderdrukt.
Gerelateerde lessen
- Java · Les 54 · Gevorderd · Versie: 2