Spring Boot 4:n kattava opas · Oppitunti

REST-ohjainten luominen

Suunnitelkaa ja toteuttakaa RESTful-päätepisteitä `@RestController`-annotaation ja erilaisten mapping-annotaatioiden avulla.

Oppitunti 1/412 vaihetta

REST-ohjainten luominen on ilmainen Spring Boot 4:n kattava opas-oppitunti CoddyKitissä. Tämä on oppitunti 1/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu Spring Boot 4:n kattava opas-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Spring Boot 4:n kattava opas-kurssilla on yhteensä 4 oppituntia.

Tervetuloa REST-ohjainten pariin!

Olet aloittamassa tehokkaiden verkkopalveluiden rakentamisen Spring Bootilla! Tänään opit luomaan RESTful-rajapintoja, jotka muodostavat nykyaikaisten verkkosovellusten perustan.

REST-rajapinta on standardoitu tapa, jolla eri tietojärjestelmät voivat viestiä keskenään internetin välityksellä.

Mitä RESTful-rajapinnat ovat?

REST on lyhenne sanoista REpresentational State Transfer. Se on verkottuneille sovelluksille tarkoitettu arkkitehtuurityyli.

Resurssit: Kaikki on resurssi, kuten käyttäjä tai tuote.
Yksilölliset tunnisteet: Jokaisella resurssilla on yksilöllinen URL, kuten /users/123.
Standardoidut metodit: Resurssien käsittelyyn käytetään standardoituja HTTP-metodeja, kuten GET, POST, PUT ja DELETE.

Spring Boot tekee näiden toteuttamisesta helppoa!

`@RestController`-annotaation esittely

Spring Bootissa @RestController-annotaatio on keskeinen RESTful-verkkopalveluiden rakentamisessa. Se on Spring-komponentin erityistyyppi.

Se kertoo Springille, että tämä luokka käsittelee saapuvia verkkopyyntöjä.
Se yhdistää @Controller- ja @ResponseBody-annotaatiot.

@ResponseBody tarkoittaa, että metodien palautusarvo sidotaan suoraan verkkovastauksen runkoon.

Ensimmäinen GET-päätepiste

Luodaan yksinkertainen päätepiste, joka vastaa GET-pyyntöön. GET-pyyntöjä käytetään tietojen hakemiseen.

@GetMapping-annotaation avulla HTTP GET -pyynnöt yhdistetään tiettyihin käsittelijämetodeihin.

Suoritettava GET-esimerkki

Kokeile suorittaa tämä yksinkertainen Spring Boot -sovellus. Se määrittää /hello-päätepisteen, joka palauttaa tervehdyksen.

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

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

@RestController
class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from CoddyKit!";
  }
}

GET-päätepisteen testaaminen

Kun edellinen koodi on suoritettu, Spring Boot -sovellus käynnistyy oletusarvoisesti portissa 8080.

Voit käyttää uutta päätepistettä avaamalla selaimen ja siirtymällä osoitteeseen:

http://localhost:8080/hello

Sinun pitäisi nähdä näytöllä viesti "Hello from CoddyKit!".

`@PostMapping`-annotaation esittely

GET-pyyntöjä käytetään tietojen hakemiseen, kun taas POST-pyyntöjä käytetään yleensä uusien resurssien luomiseen palvelimelle.

@PostMapping-annotaatio yhdistää HTTP POST -pyynnöt tiettyyn metodiin. Kun lähetät tietoja, ne ovat usein niin sanotussa pyyntörungossa (request body).

Käytämme @RequestBody-annotaatiota ilmoittamaan Springille, että saapuva pyyntörunko muunnetaan Java-olioksi (tai yksinkertaiseksi String-arvoksi).

Toimiva POST-esimerkki

Lisätään olemassa olevaan controlleriin POST-päätepiste. Tämä päätepiste vastaanottaa nimen pyyntörungossa ja palauttaa henkilökohtaisen tervehdyksen.

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

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

@RestController
class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from CoddyKit!";
  }

  @PostMapping("/greet")
  public String greetUser(@RequestBody String name) {
    return "Hello, " + name + "!";
  }
}

Polkumuuttujat `@PathVariable`-annotaatiolla

Joskus haluat poimia arvon suoraan URL-osoitteen polusta. Tällöin polkumuuttujat ovat hyödyllisiä.

@PathVariable-annotaation avulla URL-mallin muuttuja voidaan yhdistää metodin parametriin.

Esimerkki-URL: /users/123
Tässä 123 on polkumuuttuja, joka edustaa käyttäjän tunnistetta.

Polkumuuttujien käyttäminen koodissa

Tässä esimerkissä lisätään päätepiste, joka käyttää polkumuuttujaa tervehtiäkseen tiettyä henkilöä, jonka nimi on osa URL-osoitetta.

package com.coddykit;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

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

@RestController
class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from CoddyKit!";
  }

  @PostMapping("/greet")
  public String greetUser(@RequestBody String name) {
    return "Hello, " + name + "!";
  }

  @GetMapping("/greet/{name}")
  public String greetPathVar(@PathVariable String name) {
    return "Greetings, " + name + " from path!";
  }
}

Pikatarkistus: controllerin perusteet

Olet tutustunut `@RestController`-annotaatioon ja perusmääritysannotaatioihin. Testataanpa ymmärrystäsi.

Vastaa interaktiivisessa oppitunnissa

Kertaus: REST-controllerien luominen

Hienoa työtä! Olet ottanut ensimmäiset askeleesi RESTful API -rajapintojen rakentamisessa Spring Bootilla:

Opimme, mitä RESTful API -rajapinnat ovat ja mihin niitä käytetään.
Tutustuimme keskeiseen @RestController-annotaatioon.
Toteutit ja testasit GET-pyyntöjen päätepisteitä käyttämällä @GetMapping-annotaatiota.
Loit myös perusmuotoisen POST-päätepisteen @PostMapping-annotaatiolla ja käytit @RequestBody-annotaatiota.
Lopuksi näit, miten URL-osoitteista poimitaan muuttuvia tietoja @PathVariable-annotaation avulla.

Seuraavaksi perehdymme tarkemmin erilaisten HTTP-pyyntöjen käsittelyyn ja vastausten muodostamiseen!

Aloita maksutta

Opi Java 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: 21
Oppitunnit: 84

Aloita opiskelu maksutta Näytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”REST-ohjainten luominen” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Spring Boot 4:n kattava opas-oppimispolun 3 oppituntia, myös oppitunnin “REST-ohjainten luominen”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Spring Boot 4:n kattava opas-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”REST-ohjainten luominen”?

Suunnitelkaa ja toteuttakaa RESTful-päätepisteitä `@RestController`-annotaation ja erilaisten mapping-annotaatioiden avulla. Harjoittelet Spring Boot 4:n kattava opas-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni Spring Boot 4:n kattava opas-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin Spring Boot 4:n kattava opas-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 1/4.

Kuinka kauan ”REST-ohjainten luominen”-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ä Spring Boot 4:n kattava opas-oppitunnilla?

Kyllä. Jokainen Spring Boot 4:n kattava opas-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

REST-ohjainten luominen
HTTP-pyyntöjen ja -vastausten käsittely
Syötteen validointi ja virheenkäsittely
REST-API:en dokumentointi OpenAPI:lla ja Swaggerilla

← Takaisin: Spring Boot 4:n kattava opas