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 classePublisherqui 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
@Entitypour indiquer qu'il s'agit d'une entité JPA. -
Annoter l'attribut
idavec@Idet@GeneratedValuepour 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 interfacePublisherRepositoryqui é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 classeBookqui 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
@Entitypour indiquer qu'il s'agit d'une entité JPA. -
Annoter l'attribut
idavec@Idet@GeneratedValuepour indiquer qu'il s'agit de la clé primaire et qu'elle est générée automatiquement. -
Annoter l'attribut
publisheravec@ManyToOnepour indiquer la relation entreBooketPublisher.
Partie 5: Création de l'interface BookRepository
- Dans le package
repository, créez une interfaceBookRepositoryqui étendJpaRepository<Book, Long>.
Partie 6: Création des contrôleurs
-
Dans le package
controller, créez une classePublisherControlleravec 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
BookControlleravec 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);
}
}