ajout du scenario cucumber et du README
This commit is contained in:
RKaraMos_EVO
@@ -0,0 +1,78 @@
|
||||
# mylibrary — back-end Java (méthode BDD)
|
||||
|
||||
Back-end du projet **2026-DEV-BUT3**. Reproduit, en Java pur, le cœur métier
|
||||
de l'API consommée par le front React `my-library/`.
|
||||
|
||||
## Méthode
|
||||
|
||||
Conformément au cours `maintenanceApplicativeCours1.pdf` (Behavior-Driven
|
||||
Development), pour chaque comportement on :
|
||||
|
||||
1. Écrit le scénario attendu (en Gherkin / `.feature` ou en `@DisplayName` JUnit)
|
||||
2. Écrit le test qui le vérifie
|
||||
3. Implémente le code qui fait passer le test
|
||||
|
||||
## Structure (calquée sur le module `customer` fourni par le prof)
|
||||
|
||||
```
|
||||
src/main/java/fr/iut_fbleau/but3/dev62/mylibrary/
|
||||
├─ customer/ Module fourni par l'enseignant (intact)
|
||||
│ ├─ CustomerInfo.java record d'entrée
|
||||
│ ├─ CustomerDTO.java DTO de sortie
|
||||
│ ├─ entity/ Customer (objet métier, règles fidélité)
|
||||
│ ├─ exception/ Exceptions métier
|
||||
│ ├─ converter/ Mapping Info <-> entity <-> DTO
|
||||
│ ├─ validator/ Règles de validation
|
||||
│ ├─ repository/ Stockage en mémoire (List)
|
||||
│ └─ usecase/ Cas d'usage (orchestration)
|
||||
└─ book/ Module développé en miroir (notre travail)
|
||||
└─ … (mêmes sous-paquets, même découpage)
|
||||
|
||||
src/test/java/.../mylibrary/
|
||||
├─ customer/ Tests JUnit fournis par l'enseignant
|
||||
├─ book/ Tests JUnit que nous avons écrits
|
||||
└─ features/
|
||||
├─ RunCucumberTest.java (du prof, intact)
|
||||
├─ client/CustomerSteps.java (du prof, intact)
|
||||
├─ book/BookSteps.java (notre travail)
|
||||
└─ resources/features/
|
||||
├─ client.feature (du prof, intact)
|
||||
└─ book.feature (notre travail)
|
||||
```
|
||||
|
||||
## Dépendances
|
||||
|
||||
Strictement les mêmes que dans le template du prof :
|
||||
|
||||
- JUnit 5 (jupiter-api, params, engine + platform-suite, platform-engine, platform-launcher)
|
||||
- Mockito (core, junit-jupiter)
|
||||
- Cucumber (cucumber-java, cucumber-junit-platform-engine)
|
||||
- Lombok
|
||||
|
||||
## Build & test
|
||||
|
||||
Pré-requis : **JDK 21** + **Maven 3.9+**
|
||||
|
||||
```bash
|
||||
mvn -f mylibrary test
|
||||
```
|
||||
|
||||
Cette commande exécute :
|
||||
|
||||
- les tests unitaires JUnit (entity, validator, converter, repository, usecase, exceptions)
|
||||
- les scénarios Cucumber (`client.feature` + `book.feature`) via `RunCucumberTest`
|
||||
|
||||
## Périmètre couvert
|
||||
|
||||
Conformément à la consigne (« reproduire le strict nécessaire pour démontrer
|
||||
la maîtrise »), l'API se limite aux deux domaines présents dans le swagger
|
||||
qui structurent l'app React :
|
||||
|
||||
- **Catalogue** (`book`) : enregistrer, consulter par ISBN, lister tous les livres,
|
||||
refuser ISBN dupliqué, refuser un livre invalide, gérer le stock.
|
||||
- **Comptes clients** (`customer`) : enregistrer, consulter par téléphone, mettre
|
||||
à jour, supprimer, ajouter / retirer des points de fidélité (module fourni).
|
||||
|
||||
L'exposition HTTP réelle utilisée par les développeurs front est l'API du prof
|
||||
(`mylibrary-0.0.1-SNAPSHOT.jar`) ; ce module sert à démontrer la maîtrise
|
||||
de la **conception métier en BDD/TDD**.
|
||||
+106
@@ -0,0 +1,106 @@
|
||||
package fr.iut_fbleau.but3.dev62.mylibrary.features.book;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.BookDTO;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.BookInfo;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.entity.Category;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookAlreadyExistsException;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.BookNotFoundException;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.exception.NotValidBookException;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.repository.BookRepository;
|
||||
import fr.iut_fbleau.but3.dev62.mylibrary.book.usecase.BookUseCase;
|
||||
import io.cucumber.datatable.DataTable;
|
||||
import io.cucumber.java.en.And;
|
||||
import io.cucumber.java.en.Given;
|
||||
import io.cucumber.java.en.Then;
|
||||
import io.cucumber.java.en.When;
|
||||
import java.time.LocalDate;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
public class BookSteps {
|
||||
|
||||
private final BookRepository bookRepository = new BookRepository();
|
||||
private final BookUseCase bookUseCase = new BookUseCase(bookRepository);
|
||||
|
||||
private long lastRegisteredIsbn;
|
||||
private BookDTO retrievedBook;
|
||||
private List<BookDTO> allBooks;
|
||||
private Exception lastException;
|
||||
|
||||
@Given("the catalog has the following books:")
|
||||
public void theCatalogHasTheFollowingBooks(DataTable dataTable) throws NotValidBookException, BookAlreadyExistsException {
|
||||
bookRepository.deleteAll();
|
||||
for (Map<String, String> row : dataTable.asMaps(String.class, String.class)) {
|
||||
bookUseCase.registerBook(toBookInfo(row));
|
||||
}
|
||||
}
|
||||
|
||||
@When("I register a new book with the following information:")
|
||||
public void iRegisterANewBook(DataTable dataTable) throws NotValidBookException, BookAlreadyExistsException {
|
||||
Map<String, String> row = dataTable.asMaps(String.class, String.class).getFirst();
|
||||
lastRegisteredIsbn = bookUseCase.registerBook(toBookInfo(row));
|
||||
}
|
||||
|
||||
@When("I try to register a new book with the following information:")
|
||||
public void iTryToRegisterANewBook(DataTable dataTable) {
|
||||
Map<String, String> row = dataTable.asMaps(String.class, String.class).getFirst();
|
||||
lastException = assertThrows(Exception.class, () -> bookUseCase.registerBook(toBookInfo(row)));
|
||||
}
|
||||
|
||||
@When("I request the book with isbn {long}")
|
||||
public void iRequestTheBook(long isbn) throws BookNotFoundException {
|
||||
retrievedBook = bookUseCase.getBookByIsbn(isbn);
|
||||
}
|
||||
|
||||
@When("I list all books")
|
||||
public void iListAllBooks() {
|
||||
allBooks = bookUseCase.getAllBooks();
|
||||
}
|
||||
|
||||
@Then("the book is created")
|
||||
public void theBookIsCreated() {
|
||||
assertNotNull(lastRegisteredIsbn);
|
||||
}
|
||||
|
||||
@And("the catalog now has {int} book(s)")
|
||||
public void theCatalogNowHasNBooks(int expected) {
|
||||
assertEquals(expected, bookRepository.findAll().size());
|
||||
}
|
||||
|
||||
@Then("the registration fails with a {string}")
|
||||
public void theRegistrationFailsWith(String exceptionSimpleName) {
|
||||
assertNotNull(lastException);
|
||||
assertEquals(exceptionSimpleName, lastException.getClass().getSimpleName());
|
||||
}
|
||||
|
||||
@Then("I receive a book whose title is {string}")
|
||||
public void iReceiveABookWhoseTitleIs(String title) {
|
||||
assertNotNull(retrievedBook);
|
||||
assertEquals(title, retrievedBook.getTitle());
|
||||
}
|
||||
|
||||
@Then("I receive {int} book(s)")
|
||||
public void iReceiveNBooks(int expected) {
|
||||
assertNotNull(allBooks);
|
||||
assertEquals(expected, allBooks.size());
|
||||
}
|
||||
|
||||
private static BookInfo toBookInfo(Map<String, String> row) {
|
||||
return new BookInfo(
|
||||
Long.parseLong(row.get("isbn")),
|
||||
row.get("titre"),
|
||||
row.get("auteur"),
|
||||
row.get("editeur"),
|
||||
LocalDate.parse(row.get("datePublication")),
|
||||
Double.parseDouble(row.get("prix")),
|
||||
Integer.parseInt(row.get("stock")),
|
||||
List.of(Category.valueOf(row.get("categorie"))),
|
||||
"",
|
||||
row.get("langue")
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
# language: en
|
||||
|
||||
Feature: Manage book catalog
|
||||
|
||||
Scenario: Register a new book in the catalog
|
||||
When I register a new book with the following information:
|
||||
| isbn | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
|
||||
| 9780321125217 | DDD | Evans | AW | 2003-08-22 | 54.99 | 10 | SCIENCE | EN |
|
||||
Then the book is created
|
||||
And the catalog now has 1 book
|
||||
|
||||
Scenario: Reject duplicate ISBN
|
||||
Given the catalog has the following books:
|
||||
| isbn | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
|
||||
| 9780321125217 | DDD | Evans | AW | 2003-08-22 | 54.99 | 10 | SCIENCE | EN |
|
||||
When I try to register a new book with the following information:
|
||||
| isbn | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
|
||||
| 9780321125217 | DDD copy | Evans | AW | 2003-08-22 | 54.99 | 10 | SCIENCE | EN |
|
||||
Then the registration fails with a "BookAlreadyExistsException"
|
||||
|
||||
Scenario: Reject invalid book information
|
||||
When I try to register a new book with the following information:
|
||||
| isbn | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
|
||||
| 9780321125217 | | Evans | AW | 2003-08-22 | 0 | -1 | SCIENCE | EN |
|
||||
Then the registration fails with a "NotValidBookException"
|
||||
|
||||
Scenario: Retrieve a book by its ISBN
|
||||
Given the catalog has the following books:
|
||||
| isbn | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
|
||||
| 9780321125217 | DDD | Evans | AW | 2003-08-22 | 54.99 | 10 | SCIENCE | EN |
|
||||
When I request the book with isbn 9780321125217
|
||||
Then I receive a book whose title is "DDD"
|
||||
|
||||
Scenario: List all books in the catalog
|
||||
Given the catalog has the following books:
|
||||
| isbn | titre | auteur | editeur | datePublication | prix | stock | categorie | langue |
|
||||
| 9780321125217 | DDD | Evans | AW | 2003-08-22 | 54.99 | 10 | SCIENCE | EN |
|
||||
| 9780132350884 | Clean | Martin | PH | 2008-08-01 | 30.00 | 5 | SCIENCE | EN |
|
||||
When I list all books
|
||||
Then I receive 2 books
|
||||
Reference in New Issue
Block a user