Configurare un ambiente di sviluppo Java

Un JDK da solo è sufficiente per compilare ed eseguire Java da un terminale, ma per qualsiasi progetto più grande di qualche file vorrai un ambiente di sviluppo integrato (IDE). Un IDE ti offre il completamento automatico, il refactoring, un debugger integrato e un modello di progetto che comprende la struttura dei package Java.

Questo capitolo confronta i principali IDE, illustra una configurazione consigliata e mostra come viene organizzato su disco un tipico progetto Java.

Scegliere un IDE

I tre IDE Java più diffusi sono tutti gratuiti per uso individuale:

• IntelliJ IDEA Community Edition — l'IDE Java di JetBrains. La Community Edition gratuita è più che sufficiente per la maggior parte dei progetti di apprendimento e molti progetti in produzione; la Ultimate Edition a pagamento aggiunge il supporto a framework come Spring e Jakarta EE. Consigliato per questo libro.
• Eclipse IDE — l'IDE open source di lunga data, molto diffuso nelle grandi aziende.
• VS Code con l'Extension Pack for Java — più leggero di IntelliJ o Eclipse, adatto se già usi VS Code per altri linguaggi.

Puoi anche seguire il corso con un semplice editor di testo (Vim, Sublime, Notepad) e usare direttamente i comandi javac e java — i primi capitoli di questo libro mostrano entrambi gli stili.

IntelliJ IDEA: una configurazione consigliata

Se non hai una preferenza particolare, installa IntelliJ IDEA Community Edition.

1. Scaricalo da jetbrains.com/idea ed esegui il programma di installazione.
2. Avvia IntelliJ e apri la finestra di dialogo New Project.
3. Seleziona Java, poi scegli il JDK installato nel capitolo precedente dal menu a tendina JDK (IntelliJ di solito lo rileva automaticamente; in caso contrario, fai clic su Download JDK o Add JDK).
4. Scegli Maven o Gradle come sistema di build se ne vuoi uno, oppure IntelliJ per un semplice progetto di apprendimento.
5. Fai clic su Create.

IntelliJ aprirà il nuovo progetto, lo indicizzerà e posizionerà il cursore all'interno di un Main.java vuoto. Premi Shift+F10 (Windows/Linux) o Control+R (macOS) per eseguirlo.

VS Code

1. Installa VS Code.
2. Apri la barra laterale Extensions e cerca Extension Pack for Java (pubblicato da Microsoft).
3. Installalo. Il pacchetto include il server del linguaggio Java, il debugger, il supporto Maven e alcune estensioni correlate.
4. Apri una cartella contenente un file .java. VS Code rileverà il JDK e offrirà di eseguire o fare il debug del programma tramite le icone nella barra laterale.

Se VS Code non riesce a trovare il tuo JDK, imposta la voce java.jdt.ls.java.home alla radice di installazione del JDK (la directory che contiene bin/javac).

Eclipse

1. Scarica il pacchetto Eclipse IDE for Java Developers da eclipse.org.
2. Decomprimi e avvia.
3. Usa File → New → Java Project, assegnagli un nome e accetta il JDK predefinito. Eclipse crea una cartella src/ in cui risiedono i file .java.

Struttura del progetto

La maggior parte dei progetti Java segue una convenzione resa popolare da Maven e adottata da Gradle:

my-project/
├── pom.xml               # Maven build file (or build.gradle for Gradle)
├── src/
│   ├── main/
│   │   ├── java/         # production source files
│   │   │   └── com/example/MyApp.java
│   │   └── resources/    # config files, templates, properties
│   └── test/
│       ├── java/         # test source files
│       │   └── com/example/MyAppTest.java
│       └── resources/    # test fixtures
└── target/               # compiled output (gitignored)

La directory src/main/java rispecchia la gerarchia dei package: una classe dichiarata come package com.example; si trova in src/main/java/com/example/. Non è solo una convenzione — il compilatore Java si rifiuta di trovare una classe la cui dichiarazione package non corrisponde al percorso della sua cartella, quindi la struttura delle directory e i nomi dei package devono corrispondere esattamente. Rispetta questo layout e ogni strumento Java saprà dove trovare il tuo codice.

Per i primi capitoli di questo libro non hai bisogno di tutto questo — un singolo file .java in qualsiasi cartella è sufficiente per iniziare.

Configurare JAVA_HOME e il PATH

Se il tuo IDE riesce a trovare java e javac dai menu, non è necessario modificare le variabili d'ambiente. Ma nel momento in cui passi al terminale — o usi Maven, Gradle, Spring Boot o qualsiasi strumento da riga di comando — questi hanno bisogno che JAVA_HOME sia impostata.

JAVA_HOME è una variabile d'ambiente che punta alla radice dell'installazione del JDK (la cartella che contiene bin/, lib/ e così via). Gli strumenti di build la leggono per individuare il compilatore e la libreria standard, quindi un JAVA_HOME mancante o errato è il motivo più comune per cui mvn o gradle falliscono subito dopo l'installazione.

Verifica la configurazione da un terminale:

java -version    # prints the runtime version, e.g. "openjdk 21.0.2"
javac -version   # prints the compiler version; should match the above
echo $JAVA_HOME  # on Windows: echo %JAVA_HOME%

Se java -version e javac -version riportano versioni diverse, il tuo PATH e JAVA_HOME puntano a JDK diversi — correggilo prima di compilare qualsiasi cosa.

Vedi Come installare Java (JDK) per gli snippet specifici per piattaforma, oppure usa un version manager come SDKMAN! che imposta JAVA_HOME per ogni shell automaticamente.

Scorciatoie da tastiera utili

Le poche scorciatoie che userai costantemente in IntelliJ:

• Esegui — Shift+F10 (Win/Linux) / Control+R (macOS)
• Debug — Shift+F9 / Control+D
• Formatta file — Ctrl+Alt+L / Cmd+Option+L
• Correzione rapida — Alt+Enter / Option+Return
• Cerca ovunque — Shift Shift (doppio tap)
• Rinomina simbolo — Shift+F6

VS Code ed Eclipse dispongono di equivalenti nei rispettivi menu Keymap.

Cosa viene dopo

Sei pronto a scrivere codice. Il Programma Java Hello World illustra un primo programma completo riga per riga, e Come compilare ed eseguire un programma Java mostra cosa accade dietro le quinte quando l'IDE fa clic su Run.

Esercitazione