CKTIS / Java
Refleksja w Javie: nazwy typów, zadeklarowane składowe i konstruktory
Odczytaj nazwę typu, znajdź pola i metody zadeklarowane bezpośrednio w typie oraz utwórz obiekt za pomocą wybranego konstruktora, odróżniając wyszukiwanie od kontroli dostępu.
Wersja: Java SE 21
Składnia
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, InvocationTargetExceptionW Java SE 21 Class.getName() zwraca nazwę binarną klasy lub interfejsu, o ile typ nie jest ukryty, np. demo.Main$Item. Typ ukryty ma specjalną nazwę z sufiksem po /, tablica używa kodowania takiego jak [I, a typ pierwotny i void zachowują pisownię słowa kluczowego. Class.getSimpleName() zwraca prostą nazwę ze źródła, np. Item, pusty napis dla klasy anonimowej i dodaje [] do prostej nazwy typu elementu tablicy.
getDeclaredFields() i getDeclaredMethods() zwracają odpowiednio tablice Field[] i Method[]. Obejmują składowe zadeklarowane bezpośrednio w typie niezależnie od poziomu dostępu, nawet private, ale pomijają składowe dziedziczone. Zwykłe getFields() i getMethods() ograniczają się do składowych publicznych i mogą uwzględniać dziedziczone. Kolejność wyników nie jest gwarantowana; lista metod może zawierać metody mostkowe lub inne metody syntetyczne.
getDeclaredField(name) szuka pola po nazwie; brak wyniku oznacza NoSuchFieldException. getDeclaredMethod(name, parameterTypes...) używa nazwy i dokładnych typów parametrów formalnych w kolejności deklaracji. getDeclaredConstructor(parameterTypes...) tak samo dopasowuje parametry i zwraca Constructor<T>, również dla konstruktora niepublicznego. Brak metody lub konstruktora oznacza NoSuchMethodException. Nie ma dopasowania przez boxing ani przez podtypy: int.class i Integer.class to różne typy. Dla parametru String... podaj String[].class; dla sygnatury bez parametrów pomiń argumenty typów. Typ zwracany nie jest argumentem wyszukiwania metody: jeśli pasuje kilka metod, wygrywa ta z typem zwracanym bardziej szczegółowym niż wszystkie pozostałe, a jeśli takiej nie ma, wybór jest dowolny.
Znalezienie składowej nie daje prawa do jej użycia. Przy próbie zniesienia kontroli dostępu do prywatnej składowej w innym module pakiet musi być otwarty dla modułu wywołującego. Jeśli ograniczenia dostępu na to nie pozwalają, trySetAccessible() zwraca false, a setAccessible(true) zgłasza InaccessibleObjectException. W Java SE 21 obie metody mogą zgłosić SecurityException, jeśli zainstalowany menedżer zabezpieczeń odmówi uprawnienia ReflectPermission("suppressAccessChecks").
Przy wyszukiwaniu konstruktora podajesz obiekty Class reprezentujące typy parametrów. Przy wywołaniu już wybranego konstruktora Constructor.newInstance przyjmuje rzeczywiste wartości argumentów, w tym obiekt Class, jeśli pasuje on do typu danego parametru. Obsługuje m.in. unboxing i dozwolone konwersje rozszerzające. Dla niestatycznej klasy członkowskiej najpierw podaj typ klasy otaczającej przy wyszukiwaniu, a jej instancję przy wywołaniu. Jeśli kontrole przejdą pomyślnie, klasa zostanie w razie potrzeby zainicjalizowana przed utworzeniem obiektu. Brak dostępu powoduje IllegalAccessException, zła liczba lub niezgodne typy argumentów albo konstruktor typu enum powodują IllegalArgumentException, a klasa abstrakcyjna — InstantiationException. Wyjątek z konstruktora jest opakowany w InvocationTargetException; przyczynę odczytasz przez getCause(). Inicjalizacja klasy może osobno zakończyć się błędem ExceptionInInitializerError. Nie myl tego API z Class.newInstance(), które wywołuje tylko konstruktor bezargumentowy i jest przestarzałe od Javy 9.
Przykłady
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));
}
}Wynik
demo.Main$Item Item [count] [label(String), label(int)] int count=7
Listy są sortowane przed wypisaniem. `inherited` i `reset` pochodzą z `Base`, więc nie pojawiają się na listach `Item`. `int.class` wybiera `label(int)`, a `7` trafia do konstruktora. `Main` i `Item` należą do tego samego gniazda klas, więc nie trzeba wyłączać kontroli dostępu do prywatnego konstruktora ani metody.
Powiązane lekcje
- Java · Lekcja 54 · Zaawansowany · Wersja: 2