API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway) · Oppitunti

Perusmuotoisen yhdyskäytäväprojektin käyttöönotto

Alustakaa Spring Boot -projekti Spring Cloud Gatewaylla ja määrittäkää toimiva yksinkertainen yhdyskäytävä.

Oppitunti 2/411 vaihetta

Perusmuotoisen yhdyskäytäväprojektin käyttöönotto on ilmainen API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-oppitunti CoddyKitissä. Tämä on oppitunti 2/4. Voit lukea koko oppitunnin alta ilmaiseksi ja harjoitella sen jälkeen käytännössä selaimessa sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla. Oppitunti kuuluu API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-kurssilla on yhteensä 4 oppituntia.

Yhdyskäytäväprojektin määrittäminen

Tervetuloa! Tässä oppitunnissa opitte alustamaan yksinkertaisen Spring Cloud Gateway -projektin. Tämä on ensimmäinen askel tehokkaiden API-yhdyskäytävien rakentamisessa.

Käymme läpi tarvittavien riippuvuuksien määrittämisen ja minimaalisen toimivan yhdyskäytäväkokoonpanon luomisen.

Mitä tarvitsette

Varmistakaa ennen aloittamista, että seuraavat työkalut on asennettu:

  • Java Development Kit (JDK) 17+: Spring Boot -sovellusten suorittamiseen.
  • Maven tai Gradle: koontia automatisoivat työkalut projektin riippuvuuksien hallintaan.
  • IDE (esimerkiksi IntelliJ IDEA tai VS Code): koodin kirjoittamiseen ja hallintaan.

Nämä ovat Spring Boot -kehityksen vakiotyökaluja.

Aloittaminen Spring Initializrilla

Helpoin tapa aloittaa mikä tahansa Spring Boot -projekti on käyttää Spring Initializr -palvelua. Sen avulla voitte luoda projektin, jossa on kaikki tarvittavat asetukset.

Yhdyskäytävää varten valitsette tietyt riippuvuudet, jotta pääsette nopeasti alkuun.

Yhdyskäytävän keskeiset riippuvuudet

Kun käytätte Spring Initializr -palvelua, etsikää ja lisätkää seuraavat keskeiset riippuvuudet:

  • Spring Cloud Gateway: Tämä on yhdyskäytävätoiminnallisuuden tarjoava ydinkirjasto.
  • Spring WebFlux: Yhdyskäytävä perustuu reaktiiviseen ohjelmointiin, joten WebFlux on transitiviinen riippuvuus ja sen toiminnan kannalta olennainen.

Valitkaa haluamanne koontityökalu (Maven tai Gradle) ja Javan versio (esimerkiksi 17 tai 21).

Pääsovellusluokka

Kun projekti on luotu ja tuotu kehitysympäristöön, löydätte pääsovellusluokan. Tämä luokka käyttää @SpringBootApplication-annotaatiota sovelluksen käynnistämiseen.

Suorittakaa tämä yksinkertainen Spring Boot -sovellus nähdäksenne sen käynnistyvän. Se ei vielä tee paljoa, mutta se on toiminnassa!

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class GatewayProjectApplication {

  public static void main(String[] args) {
    SpringApplication.run(GatewayProjectApplication.class, args);
  }
}

Yhdyskäytävän reittien määrittäminen

Kun sovellus osaa nyt käynnistyä, yhdyskäytävälle on kerrottava, mitä sen tulee tehdä! Tämä tehdään määrittelemällä reitit tiedostossa application.yml (tai application.properties).

Reitti yhdistää saapuvat pyynnöt tiettyyn taustapalveluun tiettyjen ehtojen perusteella.

Yksinkertainen reittiesimerkki

Lisätään tiedostoon src/main/resources/application.yml yksinkertainen reitti. Tämä reitti välittää polusta /get tulevat pyynnöt osoitteeseen http://httpbin.org:80, joka on julkinen testauspalvelu.

Tämä on ensimmäinen askelenne pyyntöjen välityspalvelimeksi määrittämisessä!

spring:
  cloud:
    gateway:
      routes:
        - id: httpbin_route
          uri: http://httpbin.org:80
          predicates:
            - Path=/get

Reitin ymmärtäminen

Puretaan reittimääritys osiin:

  • id: httpbin_route: Reitin yksilöivä tunniste.
  • uri: http://httpbin.org:80: Kohteena olevan taustapalvelun URL-osoite, johon pyynnöt välitetään.
  • predicates: - Path=/get: Ehto, jonka on täytyttävä, jotta tämä reitti aktivoituu. Tässä tapauksessa se tarkoittaa kaikkia pyyntöjä, joiden polku alkaa merkkijonolla /get.

Predikaatit toimivat reitityksen if-lausekkeiden tavoin.

Yhdyskäytävän suorittaminen ja testaaminen

Kun application.yml on päivitetty, käynnistäkää Spring Boot -sovellus uudelleen. Yhdyskäytävä ottaa nyt uuden reitin käyttöön.

Voitte testata sitä käyttämällä curl-komentoa tai verkkoselainta:

  • Avatkaa terminaali.
  • Suorittakaa: curl http://localhost:8080/get

Teidän pitäisi nähdä JSON-vastaus kohteesta httpbin.org, mikä osoittaa yhdyskäytävän toimivan!

Yhdyskäytävän määrityksen tarkistus

Olette juuri määrittäneet ensimmäisen Spring Cloud Gateway -projektinne!

Mikä seuraavista on ensisijainen riippuvuus, joka tarvitaan Spring Cloud Gateway -toiminnallisuuden käyttöönottamiseksi Spring Boot -projektissa?

Kertaus: yhdyskäytävän perusmääritys

Hienoa työtä! Olette oppineet:

  • Alustamaan Spring Boot -projektin Spring Initializrilla.
  • Lisäämään olennaisen spring-cloud-starter-gateway-riippuvuuden.
  • Luomaan Spring Cloud Gateway -sovelluksen perusluokan.
  • Määrittämään ensimmäisen yhdyskäytäväreittinne tiedostossa application.yml.
  • Testaamaan yhdyskäytävää varmistaaksenne pyyntöjen oikean välittämisen.

Tämä perustietämys auttaa teitä rakentamaan monimutkaisempia yhdyskäytävämäärityksiä tulevilla oppitunneilla!

Aloita maksutta

Opi API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway) tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit
12
Oppitunnit
48

Usein kysytyt kysymykset

Onko oppitunti ”Perusmuotoisen yhdyskäytäväprojektin käyttöönotto” ilmainen?

Kyllä – oppitunnin ”Perusmuotoisen yhdyskäytäväprojektin käyttöönotto” koko tekstin voi lukea täällä verkossa ilmaiseksi. Jos haluat harjoitella interaktiivisesti sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla sekä avata koko API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-kurssin, päivitä CoddyKit PROhon. API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Perusmuotoisen yhdyskäytäväprojektin käyttöönotto”?

Alustakaa Spring Boot -projekti Spring Cloud Gatewaylla ja määrittäkää toimiva yksinkertainen yhdyskäytävä. Harjoittelet API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 2/4.

Kuinka kauan ”Perusmuotoisen yhdyskäytäväprojektin käyttöönotto”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-oppitunnilla?

Kyllä. Jokainen API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

  1. Yhdyskäytävä verrattuna perinteisiin mikropalveluihin
  2. Perusmuotoisen yhdyskäytäväprojektin käyttöönotto
  3. Reittien ja predikaattien määrittäminen
  4. Reaktiivisen perustan ymmärtäminen
← Takaisin: API-yhdyskäytävä ja käänteisvälityspalvelin (Nginx + Spring Cloud Gateway)