Ora passiamo alla parte più interessante, in cui eseguiremo la nostra prima applicazione Spring Boot utilizzando un esempio pratico e analizzeremo la struttura del progetto.

Utilizzeremo IntelliJ IDEA, ma assicurati di utilizzare la versione Ultimate per lavorare con Spring Boot.

Questa versione è a pagamento, ma IntelliJ IDEA offre una prova gratuita di un mese, che ti permette di utilizzare il programma senza problemi!

Se desideri utilizzare Spring Boot con l’edizione Community, ecco un link a un articolo che spiega come fare. Bene, iniziamo!

Creazione del progetto

Per prima cosa, creare un nuovo progetto e, nel pannello di sinistra, sarà visibile Spring Boot — è necessario selezionarlo.

Successivamente, è necessario configurare le impostazioni del progetto allo stesso modo. È possibile utilizzare qualsiasi versione di Java, non è fondamentale. Assicurarsi di selezionare Maven come tipologia di build.

Dopo aver cliccato sul pulsante Next, verrà visualizzata una finestra che mostra le dipendenze che saranno incluse nella nostra applicazione.

È necessario selezionare Web -> Spring Web.

La dipendenza Spring Web è richiesta per sviluppare applicazioni web che gestiscono richieste HTTP, servizi RESTful (che verranno trattati successivamente) e molto altro. Fornisce il supporto fondamentale per la creazione di applicazioni web all'interno dell'ecosistema Spring, includendo funzionalità per il mapping delle richieste e la gestione delle eccezioni.

Selezionare il pulsante Create per configurare il progetto. Analisi rapida della struttura del progetto.

Struttura del progetto

All'inizio, si avrà una struttura come questa, e qui si troverà il file pom.xml, che rappresenta Maven. Esaminiamolo:

Si può notare molto codice che potrebbe risultare poco chiaro, ma per ora, il blocco di nostro interesse si trova all'interno dei tag <dependencies> </dependencies>.

Qui è possibile aggiungere le dipendenze selezionate durante la creazione del progetto (come Spring Web), questa dipendenza è anche chiamata starter.

Ad esempio, lo starter spring-boot-starter-web include tutte le dipendenze necessarie per lo sviluppo di applicazioni web, come Spring MVC e Tomcat (un server su cui viene eseguita la nostra applicazione), consentendo agli sviluppatori di iniziare rapidamente.

Successivamente, aggiornare la configurazione cliccando questo pulsante. In questo modo verranno importate tutte le dipendenze nel progetto.

È presente anche la directory src che, una volta espansa, mostra altre due directory chiamate main e test. La directory test viene utilizzata per la scrittura dei test, ma questo argomento verrà trattato in altre sezioni.

Quando si espande la directory main, si notano altre due directory: java e resources.

La directory resources viene utilizzata per memorizzare tutte le risorse del sito web. I file HTML sono conservati nella directory templates, mentre tutto il resto (come file CSS, JS e immagini) viene archiviato nella cartella static. Inoltre, è presente il file application.properties, dove si specificano impostazioni aggiuntive del progetto.

Questo file specifica la porta su cui il server verrà eseguito, ma è possibile modificarla e il server si avvierà su una porta diversa. Questo file sarà fondamentale quando si dovrà collegare a un database, quindi verrà analizzato in dettaglio più avanti.

Infine, nella directory java, si trova il percorso verso la nostra classe principale.

Dove viene avviata l'applicazione?

Nello screenshot è possibile vedere chiaramente dove si trova la classe principale FirstSpringBootAppApplication per l'esecuzione dell'applicazione. All'interno della directory in cui si trova la classe principale, è possibile scrivere le proprie classi ed eseguire le applicazioni.

Ora, esegui la prima applicazione e verifica che tutto funzioni come previsto.

Se hai avviato il server e visualizzi log come questi nella console, allora congratulazioni, tutto funziona correttamente!

Cosa fare se l'applicazione non si avvia?

Durante l'avvio di un'applicazione Spring Boot, potresti riscontrare un errore se la porta è già in uso. Questo accade quando un altro processo utilizza la porta specificata, impedendo alla tua applicazione di collegarsi ad essa. Per risolvere, è sufficiente modificare la porta nel file application.properties, ad esempio impostandola su 8081.

Potresti anche incontrare problemi relativi a dipendenze errate. Se hai dimenticato di includere le dipendenze necessarie o hai specificato versioni errate nel tuo pom.xml, l'applicazione non sarà in grado di trovare le classi richieste. Assicurati che tutte le dipendenze siano correttamente definite.

Inoltre, dipendenze non disponibili possono ostacolare il caricamento delle librerie a causa di problemi con la connessione internet o l'accessibilità del repository. Verifica la tua connessione e assicurati che i repository siano raggiungibili.

Infine, errori nel codice, come errori di battitura o annotazioni errate, possono causare fallimenti all'avvio. Controlla i log per i messaggi di errore e correggi eventuali problemi individuati.

Sommario

In un progetto Spring Boot, la struttura include la classe principale dell'applicazione e i file di configurazione, che si trovano in src/main/resources. L'obiettivo è semplificare la configurazione e consentire un rapido deployment dell'applicazione.