Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Reflexia v Jave: názvy typov, deklarované členy a konštruktory

Zisti názov typu, vyhľadaj priamo deklarované polia a metódy a vytvor objekt vybraným konštruktorom. Nájdenie člena a kontrola prístupu sú dva odlišné kroky.

Verzia: Java SE 21

Syntax

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 vracia Class.getName() binárny názov neskrytej triedy alebo rozhrania, napríklad demo.Main$Item. Skrytý typ má osobitný názov s príponou za /; pole používa kódovanie ako [I; primitívne typy a void používajú príslušné kľúčové slovo. Class.getSimpleName() vracia jednoduchý názov zo zdrojového kódu, napríklad Item, pri anonymnej triede prázdny reťazec a pri poli jednoduchý názov typu komponentu s pripojeným [].

getDeclaredFields() a getDeclaredMethods() vracajú Field[] a Method[]. Zahŕňajú členy deklarované priamo v type bez ohľadu na viditeľnosť, aj private, no nie zdedené členy. getFields() a getMethods() vracajú iba verejné členy a môžu zahŕňať zdedené. Poradie nie je zaručené; zoznam metód môže obsahovať premosťovacie alebo iné syntetické metódy.

getDeclaredField(name) hľadá pole podľa názvu a pri neúspechu vyvolá NoSuchFieldException. getDeclaredMethod(name, parameterTypes...) vyžaduje názov a presné formálne typy parametrov v poradí deklarácie. getDeclaredConstructor(parameterTypes...) porovnáva parametre rovnako a vracia Constructor<T>, aj pre neverejný konštruktor. Chýbajúca metóda alebo konštruktor znamená NoSuchMethodException. Vyhľadávanie nerobí boxing a neuznáva podtyp ako zhodu: int.class a Integer.class sú odlišné. Pre String... zadaj String[].class; pri signatúre bez parametrov typy nezadávaj. Návratový typ nie je vstupom vyhľadávania: ak vyhovuje viac metód, vyberie sa tá s návratovým typom špecifickejším než všetky ostatné, ak existuje; inak je výber ľubovoľný.

Nájdenie člena nedáva oprávnenie použiť ho. Na potlačenie kontroly prístupu k súkromnému členu v inom module musí byť balík otvorený pre volajúci modul. Ak to obmedzenia nedovoľujú, trySetAccessible() vráti false, kým setAccessible(true) vyvolá InaccessibleObjectException. V Java SE 21 môžu obe metódy vyvolať SecurityException, ak nainštalovaný správca zabezpečenia odmietne udeliť oprávnenie ReflectPermission("suppressAccessChecks").

Pri vyhľadávaní konštruktora objekty Class určujú typy parametrov. Pri volaní vybraného konštruktora prijíma Constructor.newInstance skutočné hodnoty argumentov. Hodnotou môže byť aj objekt Class, ak je kompatibilný s typom príslušného parametra. Podporuje napríklad unboxing a povolené rozširujúce konverzie. Pri neštatickej členskej triede zadaj pri hľadaní ako prvý typ obklopujúcej triedy a pri volaní ako prvú jej inštanciu. Ak kontroly prejdú, trieda sa podľa potreby inicializuje pred vytvorením objektu. Odopretý prístup spôsobí IllegalAccessException; nesprávny počet argumentov, nekompatibilné typy alebo konštruktor typu enum spôsobia IllegalArgumentException; abstraktná trieda spôsobí InstantiationException. Výnimka z konštruktora je zabalená v InvocationTargetException; príčinu zistíš cez getCause(). Inicializácia triedy môže samostatne zlyhať s ExceptionInInitializerError. Nezamieňaj toto API za Class.newInstance(), ktoré volá iba bezargumentový konštruktor a je zastarané od Javy 9.

Prí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ýsledok

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

Zoznamy sa pred výpisom zoradia. `inherited` a `reset` pochádzajú z `Base`, preto sa v zoznamoch `Item` neobjavia. `int.class` vyberá `label(int)` a `7` sa odovzdá konštruktoru. `Main` a `Item` patria do rovnakého hniezda tried, takže kontrolu prístupu k súkromnému konštruktoru ani metóde netreba potláčať.

Súvisiace lekcie

  • Java · Lekcia 54 · Pokročilá · Verzia: 2

Zdroje