Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Refleksija v Javi: imena tipov, deklarirani člani in konstruktorji

Preberi ime tipa, poišči polja in metode, deklarirane neposredno v njem, ter ustvari objekt z izbranim konstruktorjem. Iskanje člana loči od preverjanja dostopa.

Različica: Java SE 21

Sintaksa

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 Class.getName() vrne binarno ime neskritega razreda ali vmesnika, na primer demo.Main$Item. Skriti tip ima posebno ime s pripono za /; tabela uporablja zapis, kot je [I; primitivni tipi in void uporabijo svojo ključno besedo. Class.getSimpleName() vrne preprosto ime iz izvorne kode, na primer Item, prazen niz pri anonimnem razredu in pri tabeli preprosto ime tipa komponente z dodanim [].

getDeclaredFields() in getDeclaredMethods() vrneta Field[] oziroma Method[]. Vključujeta člane, deklarirane neposredno v tipu, ne glede na vidnost, tudi private, ne pa podedovanih članov. getFields() in getMethods() vrneta le javne člane, tudi podedovane, kadar ustrezajo. Vrstni red ni zagotovljen; seznam metod lahko vsebuje premostitvene ali druge sintetične metode.

getDeclaredField(name) poišče polje po imenu in sproži NoSuchFieldException, če ga ni. getDeclaredMethod(name, parameterTypes...) zahteva ime in natančne formalne tipe parametrov v vrstnem redu deklaracije. getDeclaredConstructor(parameterTypes...) primerja parametre enako in vrne Constructor<T> tudi za nejavni konstruktor. Manjkajoča metoda ali konstruktor povzroči NoSuchMethodException. Iskanje ne izvaja boxinga in podtipa ne šteje za ujemanje: int.class in Integer.class sta različna. Za String... navedi String[].class; pri podpisu brez parametrov ne navajaj tipov. Vračilni tip ni iskalni argument: če se ujema več metod, prevlada tista z bolj specifičnim vračilnim tipom od vseh drugih, če obstaja; sicer je izbira poljubna.

Če člana najdeš, to še ne pomeni, da ga smeš uporabiti. Za izklop preverjanja dostopa do zasebnega člana v drugem modulu mora biti paket odprt kličočemu modulu. Če dostopne omejitve to preprečujejo, trySetAccessible() vrne false, setAccessible(true) pa sproži InaccessibleObjectException. V Java SE 21 lahko obe metodi sprožita SecurityException, če nameščeni upravljalnik varnosti zavrne dovoljenje ReflectPermission("suppressAccessChecks").

Pri iskanju konstruktorja objekti Class določajo tipe parametrov. Pri klicu izbranega konstruktorja Constructor.newInstance prejme dejanske vrednosti argumentov. Vrednost je lahko tudi objekt Class, če je združljiv s tipom ustreznega parametra. Dopušča na primer unboxing in dovoljene razširitvene pretvorbe. Pri nestatičnem članskem razredu pri iskanju najprej podaj tip obdajajočega razreda, pri klicu pa njegov primerek. Če preverjanja uspejo, se razred po potrebi inicializira pred nastankom objekta. Zavrnjen dostop povzroči IllegalAccessException; napačno število argumentov, nezdružljivi tipi ali konstruktor tipa enum povzročijo IllegalArgumentException; abstrakten razred povzroči InstantiationException. Izjema iz konstruktorja je ovita v InvocationTargetException; vzrok preveri z getCause(). Inicializacija razreda lahko ločeno odpove z ExceptionInInitializerError. Tega API-ja ne zamenjaj s Class.newInstance(), ki kliče le konstruktor brez argumentov in je zastarel od Jave 9.

Primeri

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

Rezultat

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

Seznama se pred izpisom razvrstita. `inherited` in `reset` izvirata iz `Base`, zato ju na seznamih za `Item` ni. `int.class` izbere `label(int)`, `7` pa se posreduje konstruktorju. `Main` in `Item` pripadata istemu gnezdu razredov, zato preverjanja dostopa do zasebnega konstruktorja in metode ni treba izklopiti.

Povezane lekcije

  • Java · Lekcija 54 · Napredna · Različica: 2

Viri