CKTIS / Java
Refleksyjny dostęp do pól w Javie
Rozpoznaj pole oznaczone adnotacją, odczytaj jego deklarowany typ i przypisz zbudowaną zależność z uwzględnieniem reguł dostępu w Java SE 21.
Wersja: Java SE 21
Składnia
java.lang.reflect.Field — instance methods in Java SE 21
Class<?> getType()
boolean isAnnotationPresent(Class<? extends java.lang.annotation.Annotation> annotationClass)
void set(Object obj, Object value) throws IllegalArgumentException, IllegalAccessException
void setAccessible(boolean flag)java.lang.reflect.Field opisuje pole, a nie jego wartość w konkretnym obiekcie. Class.getDeclaredFields() zwraca pola zadeklarowane w danej klasie, w tym prywatne, lecz nie odziedziczone. Field.isAnnotationPresent(Inject.class) zwraca true, gdy adnotacja deklaracji @Inject jest obecna na polu; własna adnotacja musi mieć @Retention(RetentionPolicy.RUNTIME), aby refleksja ją widziała. Odczyt tych metadanych nie wymaga pomijania kontroli dostępu.
Field.getType() zwraca deklarowany typ jako Class<?>, a nie typ aktualnej wartości. Dla List<String> jest to List.class, a dla int — int.class. Do odczytu argumentów generycznych deklaracji służy getGenericType(). Przy wstrzykiwaniu zależności ustal na podstawie typu, co zbudować, dokończ budowę zależności rekurencyjnie, a dopiero potem przypisz ją do pola.
Field.setAccessible(true) pomija kontrole dostępu języka Java dla danego obiektu Field, jeśli jest to dozwolone; false przywraca kontrole. Metoda nie zmienia modyfikatorów pola. Przy dostępie do pola private z innego modułu pakiet musi być otwarty dla modułu wywołującego; samo exports nie wystarcza. Gdy nie można pominąć kontroli, metoda zgłasza InaccessibleObjectException, a trySetAccessible() w takim przypadku zwraca false. Jeśli aktywny menedżer bezpieczeństwa odmówi uprawnienia, obie metody mogą zgłosić SecurityException.
Field.set(obj, value) zapisuje wartość. Dla pola instancji obj musi być zgodną instancją: null powoduje NullPointerException, a obiekt niewłaściwego typu — IllegalArgumentException. Dla pola static argument obj jest ignorowany i może być null. Wartość musi być zgodna z typem pola; dla typów prostych metoda rozpakowuje obiekt opakowujący i dopuszcza konwersję rozszerzającą, nie zawężającą. Niezgodna wartość powoduje IllegalArgumentException.
IllegalAccessException to wyjątek kontrolowany zgłaszany przy zapisie, gdy dostęp do pola jest niedozwolony lub nie wolno zapisać pola final. Nawet po pominięciu kontroli nie można zapisywać pól static final ani pól final rekordów i klas ukrytych. Unikaj zapisu do pól final; jeśli kontrolujesz klasę, preferuj wstrzykiwanie przez konstruktor.
Przykłady
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Field;
public class Main {
public static void main(String[] args) throws ReflectiveOperationException {
System.out.println(build(Service.class).message());
}
private static <T> T build(Class<T> type) throws ReflectiveOperationException {
T instance = type.getDeclaredConstructor().newInstance();
for (Field field : type.getDeclaredFields()) {
if (!field.isAnnotationPresent(Inject.class)) {
continue;
}
Object dependency = build(field.getType());
field.setAccessible(true);
field.set(instance, dependency);
}
return instance;
}
}
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
@interface Inject {}
class Service {
@Inject
private Repository repository;
String message() {
return repository.message();
}
}
class Repository {
String message() {
return "ready";
}
}Wynik
ready
`build` tworzy `Service`, wykrywa `@Inject` i rekurencyjnie tworzy `Repository`, zanim zapisze zależność w prywatnym polu `repository`. Oczekiwany wynik to `ready`. Przykład jest celowo ograniczony do konkretnych klas z dostępnym konstruktorem bezargumentowym; nie obsługuje cykli ani wyboru implementacji interfejsów.
Powiązane lekcje
- Java · Lekcja 59 · Zaawansowany · Wersja: 2