Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Refleksja klas: nazwy, pola, konstruktory i adnotacje

Sprawdź rzeczywistą klasę obiektu w Java SE 21, odczytaj jej nazwę, znajdź zadeklarowane pola i konstruktory oraz odróżnij adnotację bezpośrednią od odziedziczonej.

Wersja: Java SE 21

Składnia

static void inspect(Base value) throws NoSuchMethodException {
    Class<Item> type = Item.class;
    Class<?> runtimeType = value.getClass();
    String name = type.getName();
    Field[] fields = type.getDeclaredFields();
    java.lang.reflect.Constructor<?>[] constructors = type.getDeclaredConstructors();
    java.lang.reflect.Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
    boolean audited = type.isAnnotationPresent(Audited.class);
}

Gdy znasz typ, użyj literału klasy, np. Item.class. Zmiennej typu T nie można użyć w literale klasy. Wywołaj Object.getClass() na obiekcie, by uzyskać jego rzeczywistą klasę, niezależnie od typu zmiennej. Class.getName() zwraca nazwę binarną klasy lub interfejsu, o ile typ nie jest ukryty (np. Main$Item). Dla typu ukrytego nazwa zawiera / z przyrostkiem, dla tablicy ma postać kodowaną, np. [I, a dla typu prostego lub void jest słowem kluczowym.

Class.getDeclaredFields() zwraca Field[] z polami zadeklarowanymi w tej klasie lub interfejsie, niezależnie od modyfikatora dostępu, bez pól odziedziczonych. getFields() zwraca tylko pola publiczne, w tym odziedziczone. Kolejność w obu tablicach nie jest gwarantowana.

Class.getDeclaredConstructors() zwraca Constructor<?>[] ze wszystkimi konstruktorami tej klasy, również prywatnymi i deklarowanymi niejawnie, bez gwarancji kolejności. Konstruktory nie są dziedziczone. getConstructors() zwraca tylko publiczne. Dla interfejsu, tablicy, typu prostego i void obie metody zwracają pustą tablicę.

Class.getDeclaredConstructor(...) zwraca jeden Constructor<T>. Podaj dokładne typy parametrów formalnych w kolejności deklaracji: int.class to nie Integer.class; brak argumentów oznacza konstruktor bezparametrowy. Dla klasy wewnętrznej zadeklarowanej w kontekście niestatycznym najpierw podaj typ instancji otaczającej. Brak dopasowania oznacza NoSuchMethodException. Znalezienie elementu nie daje prawa dostępu do pola ani wywołania konstruktora; granice modułów mogą uniemożliwić pominięcie kontroli dostępu.

Class.isAnnotationPresent(A.class) sprawdza, czy adnotacja deklaracji A jest widoczna w czasie wykonania (RetentionPolicy.RUNTIME) i obecna bezpośrednio lub, jeśli ma @Inherited, przez łańcuch nadklas, a nie interfejsów. Do sprawdzenia tylko bezpośredniej obecności użyj getDeclaredAnnotation(A.class) != null. Aby odczytać adnotacje powtarzalne zapisane w kontenerze, użyj getAnnotationsByType(A.class).

Przykłady

import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.Arrays;

public class Main {
    @Inherited
    @Retention(RetentionPolicy.RUNTIME)
    @interface Audited {}

    @Audited
    static class Base {
        public int inheritedId;
    }

    static final class Item extends Base {
        private final int size;
        public String label = "item";

        public Item() { this(0); }
        private Item(int size) { this.size = size; }
    }

    public static void main(String[] args) throws NoSuchMethodException {
        Base value = new Item();
        Class<?> type = value.getClass();
        System.out.println("type: " + type.getName());
        System.out.println("fields: " + Arrays.stream(type.getDeclaredFields())
                .map(Field::getName).sorted().toList());
        System.out.println("constructors: " + type.getDeclaredConstructors().length);
        var constructor = type.getDeclaredConstructor(int.class);
        System.out.println("int constructor is private: " + Modifier.isPrivate(constructor.getModifiers()));
        System.out.println("annotation present: " + type.isAnnotationPresent(Audited.class));
        System.out.println("annotation declared: " + (type.getDeclaredAnnotation(Audited.class) != null));
    }
}

Wynik

type: Main$Item
fields: [label, size]
constructors: 2
int constructor is private: true
annotation present: true
annotation declared: false

Zmienna ma typ `Base`, lecz obiekt jest typu `Item`. Posortowana lista zawiera prywatne `size`, ale nie odziedziczone `inheritedId`. Program znajduje prywatny konstruktor z parametrem `int`, ale go nie wywołuje. `Audited` pochodzi z `Base` i nie jest zadeklarowana bezpośrednio na `Item`.

Powiązane lekcje

  • Java · Lekcja 59 · Zaawansowany · Wersja: 2

Źródła