Aller au contenu

Architecture hexagonale — RetroGame

Ports et adaptateurs

Règle de dépendance

retrogame-domain              Java pur, aucune dépendance Spring
       ↑
retrogame-application         Ports IN/OUT, cas d'usage, Vavr Either ; aucune dépendance Spring
       ↑
retrogame-infrastructure      Adapteurs JPA/PostgreSQL et Spring Batch
       ↑
retrogame-bootstrap           Application Boot, contrôleurs REST/MVC, templates

bootstrap orchestre le câblage, mais les détails métier restent dans domain/application.

Ports entrants

Ports sortants

Adapter entrants

Adapters sortants

Exemple de scénario REST

POST /api/scores
  → ScoreDemande (DTO web + validation)
  → ScoreCommande (application)
  → EnregistrerScoreUseCase
  → ScoreApplicationService (pur Java)
  → CatalogueJeuxPort, StockageScoresPort
  → Adaptateurs JPA → PostgreSQL
  → Either<ErreurScore,Score>
  → ScoreReponse JSON (201, 400 ou 409)

Exemple de scénario Batch

POST /importer (formulaire HTML)
  → ImporterScoresUseCase
  → ImportationApplicationService (Java pur)
  → DeclencheurBatchPort → SpringBatchImportAdapter (JobLauncher)
  → Reader CSV → Processor CSV → Writer
  → EnregistrerScoreUseCase (même logique que REST)
  → StockageScoresPort → PostgreSQL
  → BilanImport → Redirect / → Thymeleaf

Comptabilité du batch : readCount = lectures abouties ; filterCount = objets éliminés par le processor ; readSkipCount = exceptions de lecture ignorées ; writeCount = items transmis au writer ; importees et rejetsMetier = compteurs spécifiques des résultats métier.

Frontière des transactions

L’adaptateur JPA gère les transactions avec @Transactional ; l’application pure Java ne connaît aucune annotation Spring.

Le Batch ouvre également des transactions par chunks.

Limites pédagogiques explicites :