Reflection e configurazione
Gestire le funzionalità dinamiche
Reflection e configurazione è una lezione Java Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Java Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Java Academy include 4 lezioni in totale.
Reflection e configurazione
L'analisi a mondo chiuso di native-image può vedere solo il codice che riesce a tracciare staticamente. Le funzionalità dinamiche — reflection, proxy, risorse e serializzazione — nascondono i propri target all'analizzatore. Questa lezione spiega come renderle operative in un binario nativo.
Il problema della reflection
Quando cercate una classe tramite il nome contenuto in una stringa, l'analizzatore non può sapere a quale classe vi riferiate. Se quella classe non è raggiungibile in altro modo, verrà esclusa dall'immagine e la ricerca fallirà a runtime.
public class Main {
public static void main(String[] args) throws Exception {
String name = "java.util.ArrayList"; // could come from config
Class<?> c = Class.forName(name);
System.out.println("Loaded: " + c.getSimpleName());
}
}Metadati di raggiungibilità
La soluzione consiste nei metadati di raggiungibilità: file JSON che indicano a native-image quali classi, metodi e campi vengono usati dinamicamente. Durante la build, questi elementi vengono mantenuti e i relativi membri vengono registrati.
reflect-config.json
Una voce di reflection indica la classe e i membri da mantenere. Questo frammento è JSON, non Java: si trova in META-INF/native-image/.
[
{
"name": "com.example.Person",
"allDeclaredConstructors": true,
"allDeclaredMethods": true,
"fields": [ { "name": "age" } ]
}
]L'agente di tracing
Scrivere a mano i metadati è laborioso. Eseguite l'app sulla JVM con il tracing agent (-agentlib:native-image-agent=config-output-dir=...). Registra ogni accesso dinamico durante un'esecuzione reale e genera automaticamente i file di configurazione.
Eseguire tutti i percorsi del codice
L'agente registra solo ciò che viene effettivamente eseguito, quindi dovete fare passare l'applicazione attraverso tutte le sue funzionalità: eseguite i test con l'agente. Qualsiasi percorso riflessivo che omettiate sarà assente dai metadati e causerà un errore nella build nativa.
Proxy dinamici
I proxy dinamici del JDK richiedono un proxy-config.json che elenchi gli insiemi di interfacce da sottoporre a proxy. L'analizzatore non può dedurli perché l'elenco delle interfacce viene composto a runtime.
Risorse
I file caricati tramite getResourceAsStream non vengono incorporati automaticamente. Un resource-config.json con modelli glob indica a native-image quali risorse includere nell'eseguibile.
public class Main {
public static void main(String[] args) {
var url = Main.class.getResource("/banner.txt");
System.out.println("Resource present: " + (url != null));
}
}Serializzazione e JNI
Anche la serializzazione Java e le chiamate native (JNI) sono dinamiche. Ognuna dispone di un proprio file di configurazione (serialization-config.json, jni-config.json). L'agente di tracing genera anche questi file quando tali percorsi vengono eseguiti.
Registrazione programmatica
Gli autori delle librerie possono registrare i metadati nel codice usando una Feature tramite l'API RuntimeReflection, eseguita in fase di build. In questo modo la configurazione corretta viene distribuita all'interno della libreria e gli utenti non devono eseguire alcuna configurazione manuale.
Repository condiviso dei metadati
GraalVM mantiene un repository condiviso dei metadati di raggiungibilità con configurazioni predefinite per le librerie più diffuse. Gli strumenti di build nativi possono recuperarlo automaticamente, così i framework comuni funzionano senza configurazione aggiuntiva.
Verifica rapida
Verificate la vostra comprensione delle funzionalità dinamiche nelle immagini native.
Riepilogo
Avete imparato a gestire le funzionalità dinamiche:
- Reflection, proxy, risorse, serializzazione e JNI sono invisibili all'analisi statica.
- I file JSON dei metadati di raggiungibilità dichiarano queste funzionalità a native-image.
- Il tracing agent genera automaticamente la configurazione a partire da un'esecuzione reale sulla JVM.
- Eseguite tutti i percorsi del codice, soprattutto i test, così non verrà tralasciato nulla.
- Usate il repository condiviso dei metadati per le librerie più diffuse.
Impara Java con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 104
- Lezioni
- 374
Domande Frequenti
La lezione «Reflection e configurazione» è gratuita?
Sì — il testo completo di «Reflection e configurazione» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Java Academy, passa a CoddyKit PRO. Il corso Java Academy include 4 lezioni in totale.
Cosa imparerò in «Reflection e configurazione»?
Gestire le funzionalità dinamiche Eserciti Java Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Java Academy?
Non è richiesta alcuna esperienza precedente. Java Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Reflection e configurazione»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Java Academy?
Sì. Ogni lezione Java Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Cos'è GraalVM
- Creare una native image
- Reflection e configurazione
- Compromessi della native image