Realizzazione Web Services attraverso Spring Boot

SPRING BOOT

MARRA GIANMARCO

INDICE

1 - WEB SERVICES.............................................................................................3

2 - CREAZIONE WEB SERVICES......................................................................4

3 - ENTITY PACKAGE........................................................................................8

3.1 - Relazioni tra tabelle...................................................................................9

4 - REPOSITORY PACKAGE............................................................................12

5 - SERVICES PACKAGE..................................................................................14

6 - CONTROLLER PACKAGE..........................................................................16

6.1 - Richiesta GET (select)............................................................................16

6.2 - Gestione eccezioni..................................................................................17

6.3 - Validazione dati.......................................................................................19

6.4 - Richiesta POST (insert)...........................................................................21

6.5 - Richiesta PUT (update)...........................................................................22

6.6 - Richiesta DELETE (delete).....................................................................22

7 - SICUREZZA BASATA SUL JWT.................................................................23

7.1 - Configurazione CORS............................................................................24

7.2 - Configurazione Sicurezza.......................................................................25

7.3 - Configurazione EntryPoint......................................................................25

7.4 - Configurazione filtro autenticazione.......................................................26

7.5 - Configurazione metodi relativi al token..................................................27

7.6 - Configurazione proprietà del token.........................................................27

2

1 - WEB SERVICES

In generale il web services è un sistema software sviluppato al fine di supportare

l’interazione tra macchina e applicazioni eterogenee.

Nello specifico, questa tipologia di software viene installata sui server con

l’obiettivo di rispondere alle richieste effettuate dal client attraverso dati di tipo

JSON (standard formattazione dati).

A differenza del pattern MVC (o simili) in questo caso il client effettua le

richieste attraverso un’applicazione intermediaria chiamata Front-end.

Front- Web

End Services Serve

Clien r

t

In questa guida analizzeremo e studieremo il framework Spring Boot

(linguaggio Java) 3

2 - CREAZIONE WEB SERVICES

In questo capitolo illustreremo come creare, attraverso una procedura guidata un

web services sfruttando il framework Spring Boot.

Iniziamo aprendo il nostro IDE di riferimento e cliccando successivamente su

new project.

Selezionare tra l’elenco visualizzato la voce Spring Boot Initializer Progect.

Scegliere le dipendenze: Spring Boot DevTools, Spring web, Driver MySQL e

JPA

Cliccare su finish per concludere la procedura. 4

Finita la creazione e il caricamento del progetto, dovremmo avere ottenuto la

seguente struttura

Dove il file Application.java contiene le istruzioni di avvio del framework.

In generale, per collegarci al web service creato abbiamo bisogno dell’indirizzo

di dominio del server, numero di porta e indirizzo del servizio chiamato in gergo

End-Point.

L’indirizzo di dominio viene assegnato automaticamente dall’IDE quando si

avvia l’applicazione (http://localhost); il numero di porta va inserito all’interno

del file application.properties Configurazione

database

Infine, gli End-Point vanno specificati all’interno del controller.

A questo punto procediamo con la creazione dell’End-Point di test in modo tale

da testare il corretto funzionamento del web services. 5

Nei Web Services è buna norma iniziare definendo prima di tutto l’unità di test

relativa all’ End-Point (definito nel controller) che si vuole realizzare. Così

facendo è possibile dettare una sorta di procedura guidata che ci indica come

bisogna implementare il relativo controller.

Supponiamo per esempio di voler creare l’unità di test del controller di

benvenuto ovvero quel End-Point che ci informa che il Web Services è attivo.

Iniziamo creando la classe TestWelcomeController nel package principale

dell’applicazione relativa al Test.

All’interno di questa inseriamo il codice seguente

Classe controller

da testare

End-Point da

testare

Valore

Atteso

All’interno dell’applicazione occorre creare un package chiamato controller

dove all’interno inseriremo tutte le classi che conterranno l’End-Point