Construire l'API, couche par couche

Sur Spring Initializr, projet Maven / Java 21, puis on ajoute les dépendances :

• Spring Web — les contrôleurs REST
• Spring Data MongoDB — l'accès à la base
• Validation — @Valid, @NotNull…
• Lombok (optionnel) — moins de code répétitif

# application.properties
spring.data.mongodb.uri=mongodb://localhost:27017/mediatheque

@Document(collection = "livres")
public class LivreEntity {
    @Id
    private String id;
    private String titre;
    private String isbn;
    private int anneePublication;
    private String auteurId;        // référence
    private List<Avis> avis;       // embarqué
    // getters / setters
}

public interface LivreRepository
        extends MongoRepository<LivreEntity, String> {

    List<LivreEntity> findByAnneePublicationGreaterThan(int annee);
    Optional<LivreEntity> findByIsbn(String isbn);
}

findAll(), findById(), save(), deleteById() existent déjà, sans code.

public record LivreDTO(
    String id,
    String titre,
    String isbn,
    double noteMoyenne,   // calculé, pas stocké
    int nbAvis
) {}

Le record Java est parfait pour un DTO : immuable et concis.

@Service
public class LivreService {
    private final LivreRepository repo;
    // injection par constructeur
    public LivreService(LivreRepository r){ this.repo=r; }

    public List<LivreDTO> lister(){
        return repo.findAll().stream()
                   .map(this::versDTO).toList();
    }
    private LivreDTO versDTO(LivreEntity e){
        double moy = e.getAvis().stream()
              .mapToInt(Avis::getNote).average().orElse(0);
        return new LivreDTO(e.getId(), e.getTitre(),
              e.getIsbn(), moy, e.getAvis().size());
    }
}

@RestController
@RequestMapping("/api/livres")
public class LivreController {
    private final LivreService service;
    public LivreController(LivreService s){ this.service=s; }

    @GetMapping
    public List<LivreDTO> lister(){ return service.lister(); }

    @GetMapping("/{id}")
    public LivreDTO consulter(@PathVariable String id){
        return service.consulter(id);
    }
}

public record CreerAvisDTO(
    @NotBlank String pseudo,
    @Min(0) @Max(5) int note,
    @Size(max=500) String commentaire
) {}

// dans le contrôleur :
public ... ajouter(@Valid @RequestBody CreerAvisDTO dto){ ... }

<!-- pom.xml -->
<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.6.0</version>
</dependency>

Sans configuration :

• UI sur /swagger-ui/index.html
• Description JSON sur /v3/api-docs

@Tag(name = "Livres")
@RestController
public class LivreController { ... }