CKTIS / Java
Izbira in klic konstruktorja z refleksijo
Izberi edini konstruktor z oznako `@Inject` ali uporabi konstruktor brez argumentov, če ni označen noben. Pred klicem preveri tipe parametrov in dostop.
Različica: Java SE 21
Sintaksa
import java.lang.reflect.Constructor;
Constructor<?>[] candidates = type.getDeclaredConstructors();
Constructor<?> ctor = type.getDeclaredConstructor(parameterTypes); // Class<?>...; exact signature
Class<?>[] formalTypes = ctor.getParameterTypes();
boolean marked = ctor.isAnnotationPresent(Inject.class);
if (!ctor.canAccess(null)) {
ctor.setAccessible(true);
}
Object instance = ctor.newInstance(arguments); // arguments is Object[]V Java SE 21 java.lang.reflect.Constructor<T> predstavlja določen konstruktor. Class.getDeclaredConstructors() vrne tudi konstruktorje, ki niso javni, in ne zagotavlja vrstnega reda; Class.getConstructors() vrne samo javne. Izberi edini konstruktor z oznako @Inject. Če jih je označenih več, sporoči dvoumnost, namesto da vzameš prvega. Če ni označen noben, uporabi Class.getDeclaredConstructor(); če konstruktor brez argumentov ne obstaja, metoda sproži NoSuchMethodException.
Constructor.isAnnotationPresent(Inject.class) preveri, ali ima sam konstruktor, ne njegovi parametri, navedeno anotacijo, vidno med izvajanjem. Primer definira lastno oznako @Inject z RetentionPolicy.RUNTIME; anotacija sama ne zagotovi odvisnosti. Constructor.getParameterTypes() vrne Class<?>[] po vrstnem redu deklaracije, brez parametrov pa prazno tabelo. Vsebuje tipe po brisanju tipov, ne vrednosti argumentov ali podrobnosti generičnih tipov. Iskanje z getDeclaredConstructor(...) zahteva natančne tipe: za int uporabi int.class, ne Integer.class.
Constructor.setAccessible(true) izključi preverjanja dostopa jezika Java za ta refleksijski objekt, ne da bi spremenil modifikatorje konstruktorja. Najprej preveri canAccess(null). Za zasebni konstruktor v drugem modulu mora biti paket odprt klicateljevemu modulu; sam izvoz ne zadošča. Če pravila dostopa med moduli ne dovoljujejo izključitve preverjanj, setAccessible(true) sproži InaccessibleObjectException, trySetAccessible() pa vrne false. Varnostni upravljalnik lahko kateri koli od teh klicev zavrne z SecurityException. Neodvisno od varnostnega upravljalnika setAccessible(true) za konstruktor razreda java.lang.Class sproži SecurityException, tudi če je paket odprt. Za tak konstruktor trySetAccessible() vrne false, razen če varnostni upravljalnik zavrne klic. setAccessible(false) znova vključi preverjanja za ta objekt.
Constructor.newInstance(Object...) pokliče že izbrani konstruktor in vrne nov primerek; ne izbira med preobremenitvami. Argumente podaj po vrstnem redu parametrov. Dovoljeni sta razpakiranje in razširitvena pretvorba primitivnega tipa, ne pa zožitvena pretvorba. Za parameter varargs konstruktorja podaj eno tabelo kot zadnji argument: vstavi jo v zunanji Object[] ali jo pretvori v Object, da refleksijski klic njenih elementov ne obravnava kot ločenih argumentov. Pri notranjem razredu, deklariranem v nestatičnem kontekstu, najprej podaj primerek obdajajočega razreda.
IllegalArgumentException lahko pomeni napačno število argumentov ali nezdružljive tipe. IllegalAccessException pomeni, da pri vključenem preverjanju dostopa klic ni bil dovoljen; InstantiationException sporoča poskus ustvarjanja primerka abstraktnega razreda. Izjema, ki jo sproži konstruktor, je ovita v InvocationTargetException; preveri getCause(). Napaka v izbranem konstruktorju ni razlog za prehod na konstruktor brez argumentov.
Primeri
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;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.CONSTRUCTOR)
@interface Inject {}
public class Main {
static <T> T create(Class<T> type) throws ReflectiveOperationException {
Constructor<?> selected = null;
for (Constructor<?> candidate : type.getDeclaredConstructors()) {
if (candidate.isAnnotationPresent(Inject.class)) {
if (selected != null) {
throw new IllegalArgumentException("Multiple @Inject constructors");
}
selected = candidate;
}
}
if (selected == null) {
selected = type.getDeclaredConstructor();
}
Class<?>[] parameters = selected.getParameterTypes();
Object[] arguments;
if (parameters.length == 0) {
arguments = new Object[0];
} else if (parameters.length == 1 && parameters[0] == String.class) {
arguments = new Object[] {"config"};
} else {
throw new IllegalArgumentException("Unsupported constructor signature");
}
if (!selected.canAccess(null)) {
selected.setAccessible(true);
}
return type.cast(selected.newInstance(arguments));
}
public static void main(String[] args) throws ReflectiveOperationException {
System.out.println(create(Service.class).name);
System.out.println(create(Fallback.class).name);
}
}
final class Service {
final String name;
Service() {
this("no-arg");
}
@Inject
private Service(String name) {
this.name = name;
}
}
final class Fallback {
final String name;
Fallback() {
name = "no-arg";
}
}Rezultat
config no-arg
`Service` uporabi zasebni konstruktor z oznako `@Inject`, čeprav ima tudi konstruktor brez argumentov. `Fallback` nima oznake in uporabi konstruktor brez argumentov. Primer poda `"config"` samo za podpis z enim parametrom tipa `String`.
Povezane lekcije
- Java · Lekcija 59 · Napredna · Različica: 2