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

CKTIS / Java

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

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

Версия: Java SE 21

Синтаксис

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, InvocationTargetException

В Java SE 21 Class.getName() връща двоичното име на клас или интерфейс, който не е скрит, например demo.Main$Item. Скритият тип има специално име с наставка след /; масивът използва кодиране като [I; примитивните типове и void използват съответната ключова дума. Class.getSimpleName() връща простото име от изходния код, например Item, празен низ за анонимен клас, а за масив — простото име на типа на компонента с добавено [].

getDeclaredFields() и getDeclaredMethods() връщат съответно Field[] и Method[]. Включват членовете, декларирани пряко в типа, независимо от видимостта им, дори private, но не и наследените. getFields() и getMethods() връщат само публични членове и могат да включват наследени. Редът не е гарантиран; списъкът с методи може да включва мостови или други синтетични методи.

getDeclaredField(name) търси поле по име и хвърля NoSuchFieldException, ако то липсва. getDeclaredMethod(name, parameterTypes...) търси по име и точните типове на формалните параметри в реда на декларацията. getDeclaredConstructor(parameterTypes...) сравнява параметрите по същия начин и връща Constructor<T> дори за непубличен конструктор. При липса на съвпадение за метод или конструктор се хвърля NoSuchMethodException. Търсенето не прилага boxing и не приема подтип за съвпадение: int.class и Integer.class са различни. За String... подай String[].class; при сигнатура без параметри не подавай типове. Типът на резултата не е аргумент при търсене на метод: ако съвпадат няколко метода, избира се този с по-специфичен тип на резултата от всички останали, ако има такъв; иначе изборът е произволен.

Намирането на член не дава право да го използваш. За да изключиш проверките за достъп до частен член в друг модул, пакетът трябва да е отворен за извикващия модул. Ако ограниченията не позволяват това, trySetAccessible() връща false, а setAccessible(true) хвърля InaccessibleObjectException. В Java SE 21 и двата метода могат да хвърлят SecurityException, ако инсталиран мениджър на сигурността откаже разрешението ReflectPermission("suppressAccessChecks").

При търсене на конструктор обектите Class указват типовете на параметрите. При извикване на избрания конструктор Constructor.newInstance приема действителните стойности на аргументите, сред които може да има и обект Class, ако е съвместим с типа на съответния параметър. Допуска преобразувания като unboxing и разрешените разширяващи преобразувания. За нестатичен член-клас подай първо типа на обхващащия клас при търсене, а при извикване — неговата инстанция. Ако проверките преминат успешно, класът се инициализира при нужда преди създаването на обекта. Отказаният достъп води до IllegalAccessException; грешният брой аргументи, несъвместимите типове или конструктор на enum водят до IllegalArgumentException; абстрактният клас води до InstantiationException. Изключение от конструктора се обвива в InvocationTargetException; използвай getCause(), за да видиш причината. Инициализацията на класа може отделно да се провали с ExceptionInInitializerError. Не бъркай този API с Class.newInstance(), който извиква само конструктор без аргументи и е отбелязан като остарял от Java 9.

Примери

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

Резултат

demo.Main$Item
Item
[count]
[label(String), label(int)]
int
count=7

Списъците се сортират преди отпечатване. `inherited` и `reset` идват от `Base` и затова не присъстват в списъците за `Item`. `int.class` избира `label(int)`, а `7` се подава на конструктора. `Main` и `Item` са в едно и също гнездо от класове, затова не е нужно да се изключват проверките за достъп до частния конструктор и метод.

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

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

Източници