TP Spring Boot
Dans ce TP, vous allez développer un système de gestion pour une bibliothèque en utilisant Spring Boot et Spring Data JPA. Nous allons créer plusieurs classes, des interfaces pour les dépôts de données et des contrôleurs pour exposer nos services via une API REST.
Partie 1: Initialisation du projet Spring Boot
-
Allez sur Spring Initializr pour générer un nouveau projet Spring Boot. Choisissez "Maven Project", "Java", et la dernière version de Spring Boot.
-
Dans la section "Project Metadata", donnez un nom de groupe et d'artefact approprié, par exemple "com.example" et "library".
-
Dans la section "Dependencies", ajoutez les dépendances suivantes: Spring Web, Spring Data JPA, et Spring Boot DevTools.
-
Cliquez sur "Generate" pour télécharger un fichier zip du projet. Décompressez le fichier et ouvrez le projet dans votre IDE favori.
Partie 2: Création de la classe Publisher
-
Dans le package
model
, créez une classePublisher
qui représente un éditeur de livres. Cette classe doit avoir les attributs suivants :id
: l'ID de l'éditeur (Long)name
: le nom de l'éditeur (String)address
: l'adresse de l'éditeur (String)
-
Annoter la classe avec
@Entity
pour indiquer qu'il s'agit d'une entité JPA. -
Annoter l'attribut
id
avec@Id
et@GeneratedValue
pour indiquer qu'il s'agit de la clé primaire et qu'elle est générée automatiquement.
Partie 3: Création de l'interface PublisherRepository
- Dans le package
repository
, créez une interfacePublisherRepository
qui étendJpaRepository<Publisher, Long>
. Cela nous donne gratuitement plusieurs méthodes pour interagir avec la base de données commefindAll()
,findById()
,save()
,delete()
, etc.
Partie 4: Création de la classe Book
-
Dans le package
model
, créez une classeBook
qui représente un livre. Cette classe doit avoir les attributs suivants :id
: l'ID du livre (Long)title
: le titre du livre (String)author
: l'auteur du livre (String)publisher
: l'éditeur du livre (Publisher
)
-
Annoter la classe avec
@Entity
pour indiquer qu'il s'agit d'une entité JPA. -
Annoter l'attribut
id
avec@Id
et@GeneratedValue
pour indiquer qu'il s'agit de la clé primaire et qu'elle est générée automatiquement. -
Annoter l'attribut
publisher
avec@ManyToOne
pour indiquer la relation entreBook
etPublisher
.
Partie 5: Création de l'interface BookRepository
- Dans le package
repository
, créez une interfaceBookRepository
qui étendJpaRepository<Book, Long>
.
Partie 6: Création des contrôleurs
-
Dans le package
controller
, créez une classePublisherController
avec une méthodegetAllPublishers()
qui retourne tous les éditeurs, et une méthodeaddPublisher()
qui ajoute un nouvel éditeur. -
Dans le même package, créez une classe
BookController
avec une méthodegetAllBooks()
qui retourne tous les livres, et une méthodeaddBook()
qui ajoute un nouveau livre.
Partie 7: Test de l'application
- Exécutez l'application et utilisez un outil comme Postman pour tester votre API REST.
Arborescence de fichiers
Voici une possible arboressence de fichiers pour ce TP :
src/
├── main/
│ ├── java/
│ │ ├── com.example.library
│ │ │ ├── LibraryApplication.java
│ │ │ ├── model/
│ │ │ │ ├── Book.java
│ │ │ │ ├── Publisher.java
│ │ │ ├── repository/
│ │ │ │ ├── BookRepository.java
│ │ │ │ ├── PublisherRepository.java
│ │ │ ├── controller/
│ │ │ │ ├── BookController.java
│ │ │ │ ├── PublisherController.java
│ ├── resources/
│ │ ├── application.properties
Code
Model
Book
package com.example.library.model;
import javax.persistence.*;
@Entity
public class Book {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String title;
private String author;
@ManyToOne
private Publisher publisher;
public Book() {
}
public Book(String title, String author, Publisher publisher) {
this.title = title;
this.author = author;
this.publisher = publisher;
}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getAuthor() {
return author;
}
public void setAuthor(String author) {
this.author = author;
}
public Publisher getPublisher() {
return publisher;
}
public void setPublisher(Publisher publisher) {
this.publisher = publisher;
}
}
Publisher
package com.example.library.model;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
@Entity
public class Publisher {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
private String address;
public Publisher() {
}
public Publisher(String name, String address) {
this.name = name;
this.address = address;
}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
}
Repository
BookRepository
package com.example.library.repository;
import com.example.library.model.Book;
import org.springframework.data.jpa.repository.JpaRepository;
public interface BookRepository extends JpaRepository<Book, Long> {
}
PublisherRepository
package com.example.library.repository;
import com.example.library.model.Publisher;
import org.springframework.data.jpa.repository.JpaRepository;
public interface PublisherRepository extends JpaRepository<Publisher, Long> {
}
Controller
BookController
package com.example.library.controller;
import com.example.library.model.Book;
import com.example.library.repository.BookRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
public class BookController {
@Autowired
private BookRepository bookRepository;
@GetMapping("/books")
public List<Book> getAllBooks() {
return bookRepository.findAll();
}
@PostMapping("/books")
public Book addBook(@RequestBody Book book) {
return bookRepository.save(book);
}
}
PublisherController
package com.example.library.controller;
import com.example.library.model.Publisher;
import com.example.library.repository.PublisherRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
public class PublisherController {
@Autowired
private PublisherRepository publisherRepository;
@GetMapping("/publishers")
public List<Publisher> getAllPublishers() {
return publisherRepository.findAll();
}
@PostMapping("/publishers")
public Publisher addPublisher(@RequestBody Publisher publisher) {
return publisherRepository.save(publisher);
}
}