Nu gaan we verder met het meest spannende onderdeel, waarin we onze eerste Spring Boot-applicatie zullen uitvoeren aan de hand van een praktisch voorbeeld en de projectstructuur zullen bespreken.

We maken gebruik van IntelliJ IDEA, maar zorg ervoor dat je de Ultimate-versie gebruikt om met Spring Boot te werken.

Deze versie is betaald, maar IntelliJ IDEA biedt een gratis proefperiode van één maand, zodat je het programma zonder problemen kunt gebruiken!

Als je Spring Boot wilt gebruiken met de Community-editie, vind je hier een link naar een artikel dat uitlegt hoe dit werkt. Laten we beginnen!

Projectaanmaak

Eerst een nieuw project aanmaken, en in het linkerpaneel verschijnt Spring Boot — deze moet geselecteerd worden.

Vervolgens de projectinstellingen configureren op dezelfde manier als ik. Elke Java-versie kan gebruikt worden, dit is niet essentieel. Zorg ervoor dat Maven als buildtype geselecteerd is!

Na het klikken op de Next knop verschijnt een venster met de afhankelijkheden die in onze applicatie worden opgenomen.

Je moet Web -> Spring Web selecteren.

De Spring Web afhankelijkheid is vereist voor het ontwikkelen van webapplicaties die HTTP-verzoeken verwerken, RESTful services (hier komen we later op terug), en veel meer. Het biedt de fundamentele ondersteuning voor het bouwen van webapplicaties binnen het Spring ecosysteem, inclusief functies voor request mapping en exception handling.

Klik op de knop Create om je project op te zetten! Laten we snel de projectstructuur doornemen.

Projectstructuur

Aanvankelijk is er een structuur zoals deze, en hier bevindt zich het pom.xml-bestand, dat Maven vertegenwoordigt. Bekijk het volgende:

Het kan opvallen dat er veel code staat die onduidelijk lijkt, maar voor nu is het blok waarin we geïnteresseerd zijn te vinden binnen de <dependencies> </dependencies>-tags.

Hier kunnen de afhankelijkheden worden toegevoegd die bij het aanmaken van het project zijn geselecteerd (zoals Spring Web), deze afhankelijkheid wordt ook wel een starter genoemd.

Bijvoorbeeld, de starter spring-boot-starter-web bevat alle benodigde afhankelijkheden voor het bouwen van webapplicaties, zoals Spring MVC en Tomcat (een server waarop onze applicatie draait), waardoor ontwikkelaars snel kunnen beginnen.

Daarna de configuratie bijwerken door op deze knop te klikken. Hiermee worden alle afhankelijkheden in het project opgehaald.

Er is ook de src-map, die bij het uitvouwen twee extra mappen toont, genaamd main en test. De test-map wordt gebruikt voor het schrijven van tests, maar dit behandelen we in andere secties.

Wanneer we de map main uitvouwen, zien we twee extra mappen: java en resources.

De map resources wordt gebruikt om alle bronnen voor onze website op te slaan. HTML-bestanden worden bewaard in de map templates, terwijl alles anders (zoals CSS-, JS-bestanden en afbeeldingen) wordt opgeslagen in de map static. Daarnaast is er het bestand application.properties, waarin we extra projectinstellingen specificeren.

Dit bestand specificeert de poort waarop de server draait, maar je kunt deze aanpassen, en de server zal op een andere poort starten. Dit bestand zal essentieel zijn wanneer we verbinden met een database, dus we zullen het later in detail bestuderen.

Ten slotte vind je in de java directory het pad naar onze hoofdklasse.

Waar wordt de applicatie zelf gestart?

Op de screenshot is duidelijk te zien waar de hoofdklasse FirstSpringBootAppApplication voor het uitvoeren van de applicatie zich bevindt. Binnen de directory waar de hoofdklasse zich bevindt, kun je je eigen klassen schrijven en applicaties uitvoeren.

Nu het eerste applicatievoorbeeld uitvoeren en controleren of alles naar behoren functioneert.

Indien de server is gestart en er logs zoals deze in de console verschijnen, dan gefeliciteerd, alles functioneert correct!

Wat als de applicatie niet start?

Bij het starten van een Spring Boot-applicatie kan een foutmelding optreden als de poort al in gebruik is. Dit gebeurt wanneer een ander proces de opgegeven poort gebruikt, waardoor deze applicatie zich er niet aan kan binden. Dit is op te lossen door de poort in het application.properties-bestand te wijzigen, bijvoorbeeld naar 8081.

Er kunnen ook problemen ontstaan door onjuiste afhankelijkheden. Indien de benodigde afhankelijkheden ontbreken of onjuiste versies zijn opgegeven in pom.xml, kan de applicatie de vereiste klassen niet vinden. Controleer of alle afhankelijkheden correct zijn gedefinieerd.

Daarnaast kunnen niet-beschikbare afhankelijkheden het laden van libraries verhinderen door problemen met de internetverbinding of de toegankelijkheid van repositories. Controleer de verbinding en zorg dat de repositories bereikbaar zijn.

Tot slot kunnen fouten in de code, zoals typefouten of onjuiste annotaties, ook opstartproblemen veroorzaken. Controleer de logs op foutmeldingen en los eventuele problemen op.

Samenvatting

In een Spring Boot-project omvat de structuur de hoofdapplicatieklasse en configuratiebestanden, die zich bevinden in src/main/resources. De nadruk ligt op vereenvoudigde configuratie en het mogelijk maken van snelle implementatie van de applicatie.