База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Рефлексия на класове: имена, полета, конструктори и анотации

Провери действителния клас на обект в Java SE 21, прочети името му, намери декларираните полета и конструктори и разграничи преките анотации от наследените.

Версия: Java SE 21

Синтаксис

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);
}

Ако знаеш типа, използвай литерал за клас, например Item.class. Типова променлива като T не може да се използва в литерал за клас. Извикай Object.getClass() върху обект, за да получиш действителния му клас по време на изпълнение, независимо от декларирания тип на променливата. Class.getName() връща двоичното име на нескрит клас или интерфейс, например Main$Item. Името на скрит тип съдържа / със суфикс, името на масив е кодирано, например [I, а при примитивен тип или void се връща съответната ключова дума.

Class.getDeclaredFields() връща Field[] с полетата, декларирани в този клас или интерфейс, независимо от нивото на достъп, без наследените полета. getFields() връща само публичните полета, включително наследените. Редът в двата масива не е гарантиран.

Class.getDeclaredConstructors() връща Constructor<?>[] с всички конструктори на класа, включително частните и неявно декларираните, без гарантиран ред. Конструкторите не се наследяват. getConstructors() връща само публичните конструктори. И двата метода връщат празен масив за интерфейс, тип масив, примитивен тип или void.

Class.getDeclaredConstructor(...) връща един Constructor<T>. Подай точните типове на формалните параметри в реда на декларацията: int.class не е Integer.class; без аргументи се търси конструктор без параметри. За вътрешен клас, деклариран в нестатичен контекст, подай първо типа на обхващащата инстанция. Ако няма съвпадение, методът хвърля NoSuchMethodException. Намирането на член не дава право за достъп до поле или извикване на конструктор; границите между модулите могат да попречат на изключването на проверките за достъп.

Class.isAnnotationPresent(A.class) проверява дали анотацията на декларация A е видима по време на изпълнение (RetentionPolicy.RUNTIME) и присъства пряко или, ако има @Inherited, по веригата от родителски класове, а не чрез интерфейси. Само пряко присъствие провери с getDeclaredAnnotation(A.class) != null. За повтаряеми анотации, съхранени в контейнер, използвай getAnnotationsByType(A.class).

Примери

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));
    }
}

Резултат

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

Променливата е декларирана като `Base`, но обектът е от тип `Item`. Сортираният списък включва частното поле `size`, но не и наследеното `inheritedId`. Програмата намира частния конструктор с параметър `int`, без да го извиква. `Audited` идва от `Base` и не е декларирана пряко върху `Item`.

Свързани уроци

  • Java · Урок 59 · Напреднало · Версия: 2

Източници