CKTIS / Java
Reflexe tříd: názvy, pole, konstruktory a anotace
Prozkoumej skutečnou třídu objektu v Java SE 21, zjisti její název, vyhledej deklarovaná pole a konstruktory a rozliš přímo přítomné anotace od zděděných.
Verze: Java SE 21
Syntaxe
static void inspect(Base value) throws NoSuchMethodException {
Class<Item> type = Item.class;
Class<?> runtimeType = value.getClass();
String name = type.getName();
Field[] fields = type.getDeclaredFields();
java.lang.reflect.Constructor<?>[] constructors = type.getDeclaredConstructors();
java.lang.reflect.Constructor<Item> constructor = type.getDeclaredConstructor(int.class);
boolean audited = type.isAnnotationPresent(Audited.class);
}Znáš-li typ, použij literál třídy, například Item.class. Typovou proměnnou, jako je T, nelze v literálu třídy použít. Volání Object.getClass() na objektu vrátí jeho skutečnou třídu za běhu bez ohledu na deklarovaný typ proměnné. Class.getName() vrací binární název třídy nebo rozhraní, které nejsou skryté, například Main$Item. Název skrytého typu obsahuje / následované příponou, název typu pole je kódovaný, například [I, a u primitivního typu nebo void se vrátí klíčové slovo.
Class.getDeclaredFields() vrací Field[] s poli deklarovanými v dané třídě nebo rozhraní bez ohledu na úroveň přístupu, ale bez zděděných polí. getFields() vrací pouze veřejná pole včetně zděděných. Pořadí není zaručeno ani v jednom z těchto polí.
Class.getDeclaredConstructors() vrací Constructor<?>[] se všemi konstruktory třídy, včetně soukromých a implicitně deklarovaných, bez zaručeného pořadí. Konstruktory se nedědí. getConstructors() vrací pouze veřejné konstruktory. Pro rozhraní, typ pole, primitivní typ nebo void obě metody vracejí prázdné pole.
Class.getDeclaredConstructor(...) vrací jeden Constructor<T>. Zadej přesné typy formálních parametrů v pořadí deklarace: int.class není Integer.class; bez argumentů hledáš konstruktor bez parametrů. U vnitřní třídy deklarované v nestatickém kontextu zadej nejdřív typ obklopující instance. Pokud žádný konstruktor neodpovídá, metoda vyvolá NoSuchMethodException. Nalezení členu neopravňuje k přístupu k poli ani k volání konstruktoru; hranice modulů mohou zabránit vypnutí kontrol přístupu.
Class.isAnnotationPresent(A.class) ověřuje, zda je deklarativní anotace A viditelná za běhu (RetentionPolicy.RUNTIME) a přítomná přímo nebo, pokud má @Inherited, prostřednictvím řetězce nadtříd, nikoli přes rozhraní. Pouze přímou přítomnost ověříš pomocí getDeclaredAnnotation(A.class) != null. Opakovatelné anotace uložené v kontejneru načteš metodou getAnnotationsByType(A.class).
Příklady
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.Arrays;
public class Main {
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@interface Audited {}
@Audited
static class Base {
public int inheritedId;
}
static final class Item extends Base {
private final int size;
public String label = "item";
public Item() { this(0); }
private Item(int size) { this.size = size; }
}
public static void main(String[] args) throws NoSuchMethodException {
Base value = new Item();
Class<?> type = value.getClass();
System.out.println("type: " + type.getName());
System.out.println("fields: " + Arrays.stream(type.getDeclaredFields())
.map(Field::getName).sorted().toList());
System.out.println("constructors: " + type.getDeclaredConstructors().length);
var constructor = type.getDeclaredConstructor(int.class);
System.out.println("int constructor is private: " + Modifier.isPrivate(constructor.getModifiers()));
System.out.println("annotation present: " + type.isAnnotationPresent(Audited.class));
System.out.println("annotation declared: " + (type.getDeclaredAnnotation(Audited.class) != null));
}
}Výsledek
type: Main$Item fields: [label, size] constructors: 2 int constructor is private: true annotation present: true annotation declared: false
Proměnná je deklarována jako `Base`, ale objekt je typu `Item`. Seřazený seznam obsahuje soukromé pole `size`, nikoli zděděné `inheritedId`. Program najde soukromý konstruktor s parametrem `int`, aniž ho zavolá. `Audited` pochází z `Base` a není deklarována přímo na `Item`.
Související lekce
- Java · Lekce 59 · Pokročilá · Verze: 2