Summary  
This chapter covers implementing a name-based lookup by defining and implementing a repository method, invoking it in the service layer, and exposing it through a controller GET endpoint that retrieves query parameters via @RequestParam.

General domain of usage  
RESTful API development

# Tehtävä

Sinun tulee **jatkaa** **sovelluksen** **toteutusta** **edellisestä luvusta** ja kehittää logiikka **tuotteen hakemiseksi nimen perusteella**.

<a href="https://codefinity.com/courses/v2/07aa78fa-7b1d-47f7-825d-309a90d6680a/c17b66e2-3128-4a58-9ef4-0b18f13b19cb/da261f4e-2a1d-45c3-a7d1-4ca13093aa65" style="text-decoration: none" target="_blank">Kuinka työskennellä GitHubin kanssa</a>.

## Repository-taso

`ProductRepository`-luokassa on jo **metodi**, jolla ei ole toteutusta. Tämä **metodi** on tarkoitettu **hakemaan tuotteita nimen perusteella**. Sinun tulee **toteuttaa** tämä **metodi**.


### Allekirjoitus

```
Product findByName(String name)
```

## Palvelutaso

Seuraavaksi siirrytään **palvelukerrokseen** `ProductService`-luokassa, jossa kutsutaan **repositoryn** `findByName()`-metodia.

### Allekirjoitus

```
Product getProductByName(String name);
```

Sinun tulee **toteuttaa logiikka**, jolla haetaan **tuote** sen **nimen** perusteella **repositorysta** ja **välitetään** se **controller-kerrokseen**.

## Controller-taso

Toteuta nyt `findProductsByName()` **metodi** luokkaan `ProductRestController` lisätäksesi **uuden päätepisteen** tuotteiden **hakemiseen** **nimen** perusteella.

Voit **käyttää** **GET-metodia** ja **URL-osoitetta** `/find`, välittäen nimen **parametrina**. Käytä `@RequestParam` **annotaatiota** saadaksesi sen **metodin parametreihin**.

### Allekirjoitus

```
Product findProductByName(@RequestParam String name);
```

Esimerkkipyyntö: `localhost:8080/find?name=product1`

Testauksen varmistaminen. Siirry polkuun `/src/test/java/com/codefinity/springbootexmshop` ja suorita kaikki testit. Testien tulee onnistua.

Tämä kurssi kattaa Spring Boot -taustakehityksen keskeiset osa-alueet, mukaan lukien HTTP:n ja Springin perusteet, RESTful-rajapintojen suunnittelun ja toteutuksen, relaatiotietokantojen käsittelyn sekä sovellusten testaamisen. Kurssin lopussa käyttäjällä on vankka ymmärrys Spring Boot -taustakehityksestä, mikä mahdollistaa kestävien RESTful-rajapintojen suunnittelun ja toteutuksen sekä tietojen tehokkaan hallinnan relaatiotietokantojen avulla. Lisäksi käyttäjä saa käytännön kokemusta sovellusten testaamisesta, mikä varmistaa korkean koodin laadun ja toiminnallisuuden.

Opit taustakehityksen perusteet, mukaan lukien HTTP-protokollan toiminnan sekä HTTP:n ja HTTPS:n erot.
Tutustut myös HTTP-tilakoodeihin sekä tiedonsiirrossa käytettäviin tietomuotoihin, kuten JSON ja XML, asiakkaan ja palvelimen välillä.

Tässä osiossa perehdytään backend-kehityksen keskeisiin käsitteisiin Springin avulla. Käsittelemme useita aiheita, kuten johdannon Springiin, Inversion of Control (IoC) - ja Dependency Injection (DI) -periaatteet, Spring Boot -projektin rakenteen, Spring MVC:n, kolmitasoarkkitehtuurin sekä tehtävien hallinnan. Jokainen luku rakentuu edellisen varaan tarjoten kattavan ymmärryksen backend-kehityksestä Spring-ympäristössä.

Tämä osio kattaa RESTful API:en perusteet ja käytännön toteutuksen alkaen RESTin teoreettisesta ymmärryksestä ja sen keskeisistä periaatteista. Sisältää myös oman rajapinnan rakentamisen, DTO:iden käytön, poikkeusten käsittelyn, Swaggerin integroinnin dokumentointia varten sekä rajapinnan testaamisen.

Tässä osiossa käsitellään relaatiotietokantojen perusteita, mukaan lukien yhteyden muodostaminen, migraatiot sekä vuorovaikutus objektirelaatiomäppäinten (ORM) kanssa JPA:n ja Hibernaten avulla. Osiossa käsitellään tietokantojen integrointia Spring Boot -sovelluksiin ja tarkastellaan keskeisiä transaktiohallinnan osa-alueita tietojen eheyden varmistamiseksi. Tämän osion tavoitteena on kehittää tietokantaosaamistasi ja edistää niiden tehokasta käyttöä sovelluskehityksessä.

Tässä osiossa keskitytään taustasovellusten testaamiseen ja käsitellään keskeisiä aiheita, kuten testaamisen perusteet, yksikkötestaus JUnitilla sekä integraatiotestaus. Lisäksi tarkastellaan mock-olioiden käyttöä Mockito-kirjaston avulla tehokkaiden ja eristettyjen testien luomiseksi. Tämä osio auttaa kehittäjiä ymmärtämään testaamisen merkityksen ja oppimaan, kuinka hyödyntää työkaluja sovellustensa laadun ja luotettavuuden parantamiseksi.

Spring-Tehtävä

Tehtävä

Toteutuslogiikka

Repository-taso

Allekirjoitus

Palvelutaso

Allekirjoitus

Controller-taso

Allekirjoitus