CKTIS / Java
Refleksija u Javi: nazivi tipova, deklarirani članovi i konstruktori
Dohvati naziv tipa, pronađi polja i metode deklarirane izravno u njemu te stvori objekt odabranim konstruktorom. Pronalaženje člana nije isto što i pravo pristupa.
Verzija: Java SE 21
Sintaksa
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, InvocationTargetExceptionU Java SE 21 Class.getName() vraća binarni naziv klase ili sučelja koje nije skriveno, primjerice demo.Main$Item. Skriveni tip ima poseban naziv sa sufiksom iza /; polje vrijednosti koristi zapis poput [I; primitivni tipovi i void koriste svoju ključnu riječ. Class.getSimpleName() vraća jednostavan naziv iz izvornog koda, primjerice Item, prazan niz za anonimnu klasu, a za polje vrijednosti jednostavan naziv tipa komponente s dodanim [].
getDeclaredFields() i getDeclaredMethods() vraćaju Field[] odnosno Method[]. Obuhvaćaju članove deklarirane izravno u tipu bez obzira na vidljivost, pa i private, ali ne i naslijeđene članove. getFields() i getMethods() vraćaju samo javne članove i mogu uključiti naslijeđene. Redoslijed nije zajamčen; popis metoda može sadržavati mosne metode ili druge sintetičke metode.
getDeclaredField(name) traži polje po nazivu i baca NoSuchFieldException ako ga nema. getDeclaredMethod(name, parameterTypes...) traži prema nazivu i točnim tipovima formalnih parametara redoslijedom deklaracije. getDeclaredConstructor(parameterTypes...) uspoređuje parametre na isti način i vraća Constructor<T> čak i za konstruktor koji nije javan. Ako nema odgovarajuće metode ili konstruktora, baca se NoSuchMethodException. Pretraga ne primjenjuje boxing i ne prihvaća podtip kao podudaranje: int.class i Integer.class su različiti. Za String... navedi String[].class; za potpis bez parametara ne navodi tipove. Povratni tip nije argument pretrage: ako se podudara više metoda, prednost ima ona čiji je povratni tip specifičniji od svih ostalih, ako postoji; inače je odabir proizvoljan.
Pronalaženje člana ne daje dopuštenje za njegovo korištenje. Za isključivanje provjera pristupa privatnom članu u drugom modulu paket mora biti otvoren modulu koji poziva. Ako ograničenja to sprječavaju, trySetAccessible() vraća false, dok setAccessible(true) baca InaccessibleObjectException. U Java SE 21 obje metode mogu baciti SecurityException ako instalirani upravitelj sigurnosti uskrati dopuštenje ReflectPermission("suppressAccessChecks").
Pri pretrazi konstruktora objekti Class označavaju tipove parametara. Pri pozivu odabranog konstruktora Constructor.newInstance prima stvarne vrijednosti argumenata. Vrijednost može biti i objekt Class ako je kompatibilan s tipom odgovarajućeg parametra. Dopušta, primjerice, unboxing i dopuštene proširujuće pretvorbe. Za nestatičku klasu članicu prvo navedi tip obuhvatne klase pri pretrazi, a njezinu instancu pri pozivu. Ako provjere uspiju, klasa se po potrebi inicijalizira prije stvaranja objekta. Odbijen pristup uzrokuje IllegalAccessException; pogrešan broj argumenata, nekompatibilni tipovi ili konstruktor tipa enum uzrokuju IllegalArgumentException; apstraktna klasa uzrokuje InstantiationException. Iznimka iz konstruktora omotana je u InvocationTargetException; uzrok provjeri s getCause(). Inicijalizacija klase može zasebno završiti pogreškom ExceptionInInitializerError. Ne miješaj ovaj API s Class.newInstance(), koji poziva samo konstruktor bez argumenata i zastario je od Jave 9.
Primjeri
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));
}
}Rezultat
demo.Main$Item Item [count] [label(String), label(int)] int count=7
Popisi se sortiraju prije ispisa. `inherited` i `reset` dolaze iz `Base`, pa ih nema na popisima za `Item`. `int.class` odabire `label(int)`, a `7` se prosljeđuje konstruktoru. `Main` i `Item` pripadaju istom gnijezdu klasa, pa ne treba isključiti provjeru pristupa privatnom konstruktoru i metodi.
Povezane lekcije
- Java · Lekcija 54 · Napredno · Verzija: 2