Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Reflexe v Javě: názvy typů, deklarované členy a konstruktory

Zjisti název typu, vyhledej přímo deklarovaná pole a metody a vytvoř objekt zvoleným konstruktorem. Samotné nalezení členu ještě nezaručuje přístup k němu.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 vrací Class.getName() binární název neskryté třídy nebo rozhraní, například demo.Main$Item. Skrytý typ má zvláštní název s příponou za /; pole používá zápis jako [I; primitivní typy a void používají své klíčové slovo. Class.getSimpleName() vrací jednoduchý název ze zdrojového kódu, například Item, pro anonymní třídu prázdný řetězec a pro pole jednoduchý název typu komponenty s připojeným [].

getDeclaredFields() a getDeclaredMethods() vracejí Field[] a Method[]. Obsahují členy deklarované přímo v typu bez ohledu na úroveň přístupu, včetně private, ale ne zděděné členy. getFields() a getMethods() vracejí pouze veřejné členy a mohou zahrnovat i zděděné. Pořadí není zaručeno; seznam metod může obsahovat překlenovací metody nebo jiné syntetické metody.

getDeclaredField(name) hledá pole podle názvu a při neúspěchu vyvolá NoSuchFieldException. getDeclaredMethod(name, parameterTypes...) porovnává název a přesné typy formálních parametrů v pořadí deklarace. getDeclaredConstructor(parameterTypes...) porovnává parametry stejně a vrací Constructor<T> i pro neveřejný konstruktor. Chybějící metoda nebo konstruktor znamená NoSuchMethodException. Při hledání se neprovádí boxing ani se nepřijímá podtyp jako shoda: int.class a Integer.class jsou různé. Pro String... zadej String[].class; u signatury bez parametrů typy nezadávej. Návratový typ není vstupem vyhledávání: odpovídá-li více metod, vybere se ta s návratovým typem specifičtějším než všechny ostatní, pokud existuje; jinak je výběr libovolný.

Nalezení členu nedává právo ho použít. Potlačení kontroly přístupu k soukromému členu v jiném modulu vyžaduje, aby balíček byl otevřený volajícímu modulu. Pokud to omezení přístupu nedovolí, trySetAccessible() vrátí false, zatímco setAccessible(true) vyvolá InaccessibleObjectException. V Java SE 21 mohou obě metody vyvolat SecurityException, pokud nainstalovaný správce zabezpečení odepře oprávnění ReflectPermission("suppressAccessChecks").

Při hledání konstruktoru určují objekty Class typy parametrů. Při volání vybraného konstruktoru přijímá Constructor.newInstance skutečné hodnoty argumentů. Hodnotou může být i objekt Class, pokud je kompatibilní s typem příslušného parametru. Umožňuje například unboxing a povolené rozšiřující konverze. U nestatické členské třídy zadej při hledání jako první typ obklopující třídy a při volání jako první její instanci. Pokud kontroly projdou, třída se podle potřeby inicializuje před vytvořením objektu. Odepřený přístup způsobí IllegalAccessException; nesprávný počet argumentů, nekompatibilní typy nebo konstruktor typu enum způsobí IllegalArgumentException; abstraktní třída způsobí InstantiationException. Výjimku z konstruktoru obalí InvocationTargetException; příčinu zjistíš přes getCause(). Inicializace třídy může samostatně selhat s ExceptionInInitializerError. Nezaměňuj toto API za Class.newInstance(), které volá jen bezargumentový konstruktor a je zastaralé od Javy 9.

Příklady

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

Výsledek

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

Seznamy se před výpisem seřadí. `inherited` a `reset` pocházejí z `Base`, takže v seznamech `Item` nejsou. `int.class` vybere `label(int)` a `7` se předá konstruktoru. `Main` a `Item` patří do stejného hnízda tříd, proto není třeba potlačovat kontrolu přístupu k soukromému konstruktoru ani metodě.

Související lekce

  • Java · Lekce 54 · Pokročilá · Verze: 2

Zdroje