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

CKTIS / Java

Constructor — проверка и извикване на конструктори чрез рефлексия

java.lang.reflect.Constructor<T> описва един конструктор на клас T. С него могат да се разглеждат типовете на параметрите и анотациите и да се създават обекти при спазване на проверките за достъп и границите между модулите в Java SE 21.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Constructor<T> ctor = type.getDeclaredConstructor(parameterTypes);
Class<?>[] types = ctor.getParameterTypes();
boolean annotated = ctor.isAnnotationPresent(annotationType);
ctor.setAccessible(true);
T instance = ctor.newInstance(arguments);

java.lang.reflect.Constructor<T> представя един конструктор на клас T, а не създаден обект. Class.getConstructor(...) търси публичен конструктор, докато Class.getDeclaredConstructor(...) намира и непублични конструктори, декларирани в този клас. Търсенето изисква точни типове на параметрите: int.class и Integer.class не са взаимозаменяеми. Самото намиране на конструктор не дава право той да бъде извикан.

Constructor.getParameterTypes() връща масив Class<?>[] в реда на декларацията; при конструктор без параметри масивът е празен. Той може да включва неявни параметри, например обхващащия екземпляр на нестатичен вътрешен клас. Наследеният метод Constructor.isAnnotationPresent(...) проверява анотация на конструктора, а не на параметрите му. За да е достъпна чрез рефлексия, анотацията трябва да има RetentionPolicy.RUNTIME.

Constructor.setAccessible(true) изисква потискане на проверките за достъп на езика Java; това не променя декларацията на конструктора. Не може произволно да заобикаля границите между модулите: за достъп до частен конструктор в друг модул пакетът му трябва да е отворен за извикващия модул. Отказът може да доведе до InaccessibleObjectException или SecurityException. setAccessible(false) възстановява проверките, а trySetAccessible() може да върне false, ако достъпът не може да бъде разрешен. Предпочитайте достъпни публични API пред разчитането на частни конструктори на библиотеки.

Constructor.newInstance(...) създава и инициализира обект. Поддържа разопаковане на аргументи и разрешени разширяващи преобразувания, но не и стесняващи. Невалидните аргументи причиняват IllegalArgumentException, липсата на достъп — IllegalAccessException, а абстрактните класове — InstantiationException. Изключение, хвърлено от конструктора, се обвива в InvocationTargetException; причината може да се провери с getCause().

Примерът използва отделен клас от най-горно ниво Item, така че Main няма специален достъп като член на същото гнездо до частния му конструктор. В class path setAccessible(true) позволява извикването. Този запис се отнася за Java SE 21; производствената среда не е удостоверена.

Примери

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Constructor;
import java.util.Arrays;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.CONSTRUCTOR)
@interface Selected {}

final class Item {
    final String name;

    @Selected
    private Item(String name) {
        this.name = name;
    }
}

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Constructor<Item> ctor = Item.class.getDeclaredConstructor(String.class);
        System.out.println(Arrays.toString(ctor.getParameterTypes()));
        System.out.println(ctor.isAnnotationPresent(Selected.class));
        ctor.setAccessible(true);
        Item item = ctor.newInstance("Ada");
        System.out.println(item.name);
    }
}

Резултат

[class java.lang.String]
true
Ada

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

Източници