Siirrytään nyt kiinnostavimpaan osaan, jossa suoritetaan ensimmäinen Spring Boot -sovellus käyttäen käytännön esimerkkiä ja käydään läpi projektin rakenne.

Käytämme IntelliJ IDEA -ohjelmaa, mutta varmista, että käytössäsi on Ultimate-versio työskennellessäsi Spring Bootin kanssa.

Tämä versio on maksullinen, mutta IntelliJ IDEA tarjoaa ilmaisen yhden kuukauden kokeilujakson, jonka avulla voit käyttää ohjelmaa ilman ongelmia!

Jos haluat käyttää Spring Bootia Community-versiossa, tässä on linkki artikkeliin, jossa selitetään kuinka se onnistuu. Siirrytään eteenpäin!

Projektin luominen

Luo ensin uusi projekti, ja vasemmassa paneelissa näet Spring Bootin — sinun tulee valita se.

Seuraavaksi tulee määrittää projektin asetukset samalla tavalla kuin minä. Voit käyttää mitä tahansa Java-versiota, sillä ei ole suurta merkitystä. Varmista, että valitset Mavenin rakennustyypiksi!

Kun olet napsauttanut Next painiketta, näkyviin tulee ikkuna, jossa näkyvät riippuvuudet, jotka sisällytetään sovellukseemme.

Sinun täytyy valita Web -> Spring Web.

Tarvitsemme Spring Web riippuvuuden kehittääksemme verkkosovelluksia, jotka käsittelevät HTTP-pyyntöjä, RESTful-palveluita (käsittelemme tätä myöhemmin) ja paljon muuta. Se tarjoaa perustan verkkosovellusten rakentamiseen Spring-ekosysteemissä, mukaan lukien ominaisuudet pyyntöjen reititykseen ja poikkeusten käsittelyyn.

Napsauta Create-painiketta luodaksesi projektisi! Käydään nopeasti läpi projektin rakenne.

Projektin rakenne

Aluksi projektilla on rakenne kuten tämä, ja täältä löytyy pom.xml tiedosto, joka edustaa Mavenia. Tarkastellaan sitä:

Saatat huomata, että mukana on paljon koodia, joka voi vaikuttaa epäselvältä, mutta tällä hetkellä meitä kiinnostava lohko on sisällä <dependencies> </dependencies> tagien sisällä.

Tänne voidaan lisätä riippuvuudet, jotka valittiin projektia luodessa (kuten Spring Web), tätä riippuvuutta kutsutaan myös starteriksi.

Esimerkiksi spring-boot-starter-web starter sisältää kaikki tarvittavat riippuvuudet web-sovellusten rakentamiseen, kuten Spring MVC ja Tomcat (palvelin, jolla sovelluksemme toimii), mikä mahdollistaa kehittäjille nopean aloituksen.

Tämän jälkeen päivitä konfiguraatio napsauttamalla tätä painiketta. Tämä hakee kaikki riippuvuudet projektiin.

Lisäksi on olemassa src hakemisto, joka, kun se laajennetaan, paljastaa kaksi muuta hakemistoa nimeltä main ja test. test hakemistoa käytetään testien kirjoittamiseen, mutta käsittelemme sitä muissa osioissa.

Kun laajennamme main-hakemistoa, näemme kaksi muuta hakemistoa: java ja resources.

resources-hakemistoa käytetään verkkosivuston resurssien tallentamiseen. HTML-tiedostot säilytetään templates-hakemistossa, kun taas kaikki muu (kuten CSS-, JS-tiedostot ja kuvat) tallennetaan static-kansioon. Lisäksi on application.properties-tiedosto, jossa määritellään projektin lisäasetukset.

Tämä tiedosto määrittää portin, jolla palvelin käynnistyy, mutta sitä voi muuttaa, jolloin palvelin käynnistyy eri porttiin. Tämä tiedosto on tärkeä, kun yhdistämme tietokantaan, joten tutkimme sitä tarkemmin myöhemmin.

Lopuksi java-hakemistosta löytyy polku pääluokkaamme.

Missä sovellus käynnistyy?

Kuvakaappauksessa näkyy selkeästi, missä pääluokka FirstSpringBootAppApplication sovelluksen käynnistämistä varten sijaitsee. Hakemistossa, jossa pääluokka on, voi kirjoittaa omia luokkia ja ajaa sovelluksia.

Seuraavaksi suoritetaan ensimmäinen sovellus ja tarkistetaan, että kaikki toimii odotetusti.

Jos olet käynnistänyt palvelimen ja näet konsolissa tällaisia lokeja, niin onnittelut, kaikki toimii!

Entä jos sovellus ei käynnisty?

Spring Boot -sovellusta käynnistettäessä voi ilmetä virhe, jos portti on jo käytössä. Tämä tapahtuu, kun toinen prosessi käyttää määritettyä porttia, jolloin sovellus ei voi varata sitä. Tämän korjaamiseksi vaihda portti application.properties -tiedostossa, esimerkiksi arvoon 8081.

Myös virheelliset riippuvuudet voivat aiheuttaa ongelmia. Jos tarvittavat riippuvuudet puuttuvat tai pom.xml-tiedostossa on määritelty väärät versiot, sovellus ei löydä vaadittuja luokkia. Varmista, että kaikki riippuvuudet on määritelty oikein.

Lisäksi saatavilla olemattomat riippuvuudet voivat estää kirjastojen lataamisen esimerkiksi internet-yhteyden tai repositoryn saavutettavuuden vuoksi. Tarkista yhteys ja varmista, että repositoryt ovat saavutettavissa.

Lopuksi myös virheet koodissa, kuten kirjoitusvirheet tai väärät annotaatiot, voivat aiheuttaa käynnistysongelmia. Tarkista lokit virheilmoitusten varalta ja korjaa mahdolliset ongelmat.

Yhteenveto

Spring Boot -projektissa rakenne sisältää pääsovellusluokan ja konfiguraatiotiedostot, jotka sijaitsevat kansiossa src/main/resources. Tavoitteena on yksinkertaistaa konfiguraatiota ja mahdollistaa sovelluksen nopea käyttöönotto.