CKTIS / Java
Refleksija u Javi: pristup poljima i metodama
U Java SE 21 objekti `Field` i `Method` omogućuju pregled metapodataka i anotacija, promjenu polja i pozivanje metoda. Pronalazak privatnog člana ne daje pristup, a `setAccessible(true)` podliježe pravilima modula.
Verzija: Java SE 21
Sintaksa
Java SE 21 — java.lang.reflect
Field f = Owner.class.getDeclaredField("count");
Method m = Owner.class.getDeclaredMethod("add", int.class);
f.setAccessible(true);
m.setAccessible(true);
// Field instance methods
void setAccessible(boolean flag)
void set(Object receiver, Object value)
Object get(Object receiver)
String getName()
Class<?> getType()
void setInt(Object receiver, int value)
int getInt(Object receiver)
<T extends Annotation> T getAnnotation(Class<T> annotationType)
// Method instance methods
void setAccessible(boolean flag)
Object invoke(Object receiver, Object... args) throws IllegalAccessException, InvocationTargetException
boolean isAnnotationPresent(Class<? extends Annotation> annotationType)
String getName()Field i Method iz paketa java.lang.reflect predstavljaju članove klase. getDeclaredField(name) traži polje po točnom nazivu; getDeclaredMethod(name, parameterTypes...) odabire metodu po točnom nazivu i deklariranim tipovima parametara prema njihovu redoslijedu. int.class i Integer.class odabiru različite preopterećene inačice metode. JVM dopušta da u istoj klasi postoje metode s istim nazivom i istim tipovima parametara, ali s različitim povratnim tipovima. Ako je povratni tip jedne od metoda koje se podudaraju specifičniji od svih ostalih, getDeclaredMethod odabire tu metodu; u protivnom proizvoljno odabire jednu od metoda koje se podudaraju. Obje pretrage uključuju privatne, ali ne i naslijeđene članove. Ako nema podudaranja, izbacuju NoSuchFieldException odnosno NoSuchMethodException. Pronalazak člana ne daje pristup.
Uspješan poziv setAccessible(true) na objektu Field ili Method isključuje provjere pristupa jezika Java za taj refleksijski objekt bez promjene modifikatora člana. setAccessible(false) ponovno uključuje provjere. Za privatni član mogu se isključiti unutar istog modula. Između modula paket u kojem je član deklariran mora biti otvoren modulu koji poziva (opens); izvoz (exports) nije dovoljan. Ako modul spriječi isključivanje, setAccessible(true) izbacuje InaccessibleObjectException, dok trySetAccessible() vraća false. Ako instalirani upravitelj sigurnosti odbije zahtjev, oba poziva mogu izbaciti SecurityException.
Field.getName() vraća jednostavni naziv polja, a getType() deklarirani tip kao Class<?>, primjerice int.class. get(receiver) pakira primitivnu vrijednost u objekt; set(receiver, value) raspakirava kompatibilnu vrijednost za polje primitivnog tipa. getInt(receiver) vraća int iz polja tipa int ili iz polja primitivnog tipa koji se može proširiti u int. setInt(receiver, value) upisuje int u polje tipa int ili šireg primitivnog tipa. Te operacije ne sužavaju tipove. Isključivanje provjera ne dopušta upis u polja static final ni u polja final u zapisima (records) ili skrivenim klasama.
Method.getName() vraća jednostavni naziv metode. invoke(receiver, args...) poziva već odabranu metodu: po potrebi raspakirava primitivne argumente i može proširiti njihove tipove. Pakira primitivni rezultat, a za void vraća null. Za čitanje, pisanje i pozivanje navedi kompatibilnu instancu; za član static ciljni se objekt zanemaruje i može biti null. Vrijednost null umjesto tražene instance uzrokuje NullPointerException, a nekompatibilan ciljni objekt, vrijednost ili popis argumenata uzrokuje IllegalArgumentException. Odbijen pristup pri operaciji uzrokuje IllegalAccessException. Iznimka koju izbaci ciljna metoda omotana je u InvocationTargetException; do nje dođi pozivom getCause().
Field.getAnnotation(Label.class) vraća anotaciju deklaracije polja ili null. Method.isAnnotationPresent(Label.class) provjerava prisutnost anotacije deklaracije metode, ali je ne vraća. Definiraj tip anotacije s @Retention(RetentionPolicy.RUNTIME) kako bi bio vidljiv refleksijom. Za čitanje tih metapodataka ne treba isključiti provjere pristupa.
Primjeri
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
@Retention(RetentionPolicy.RUNTIME)
@interface Label {
String value();
}
final class Owner {
@Label("items")
private int count = 1;
@Label("operation")
private int add(int delta) {
return count + delta;
}
}
public class ReflectionMembersDemo {
public static void main(String[] args) throws ReflectiveOperationException {
Owner owner = new Owner();
Field field = Owner.class.getDeclaredField("count");
Method method = Owner.class.getDeclaredMethod("add", int.class);
try {
field.get(owner);
throw new AssertionError("Private field was readable before override");
} catch (IllegalAccessException expected) {
System.out.println("field access denied");
}
try {
method.invoke(owner, 5);
throw new AssertionError("Private method was callable before override");
} catch (IllegalAccessException expected) {
System.out.println("method access denied");
}
field.setAccessible(true);
method.setAccessible(true);
System.out.println(field.getName() + ":" + field.getType().getName()
+ " label=" + field.getAnnotation(Label.class).value());
field.set(owner, Integer.valueOf(7));
System.out.println("get=" + field.get(owner));
field.setInt(owner, 11);
System.out.println("getInt=" + field.getInt(owner));
System.out.println(method.getName() + " annotated="
+ method.isAnnotationPresent(Label.class));
System.out.println("invoke=" + method.invoke(owner, 5));
}
}Rezultat
field access denied method access denied count:int label=items get=7 getInt=11 add annotated=true invoke=16
`Owner` i `ReflectionMembersDemo` odvojene su klase najviše razine u istom modulu. Prvo čitanje i prvi poziv odbijeni su. Nakon isključivanja provjera primjer upisuje `7` i `11`; `add(5)` vraća `16` bez promjene polja `count`.
Povezane lekcije
- Java · Lekcija 54 · Napredno · Verzija: 2