Build, BOM & kit de test

Le problème qu'elle supprime

Les POM parents dérivent — et un BOM Spring écrase en silence la version de Boot choisie.

Ce qu'elle fait

Décisions et compromis

1. 01

   Nous avons choisi

   Un BOM qui ne porte que des artefacts com.krizaka ; le parent n'a pas de dependencyManagement à lui.

   Nous avons refusé

   Importer spring-boot-dependencies dans notre BOM.

   Parce que

   Importer krizaka-bom ne doit jamais figer une version que vous avez choisie. Votre BOM Spring Boot reste le vôtre ; le nôtre se pose à côté.

   Ce que cela vous coûte

   Vous importez vous-même le BOM (ou le parent) de Spring Boot.

2. 02

   Nous avons choisi

   Les règles d'architecture en tests (CodeRules, SourceRules, ConfigBindingRules : couches, injection par constructeur, état privé, pas d'injection d'Environment…).

   Nous avons refusé

   Une check-list de revue.

   Parce que

   Une règle exécutée à chaque build est la seule encore vraie six mois plus tard.

   Ce que cela vous coûte

   Les règles ont des opinions : prenez celles qui vous vont, appelez-les depuis votre propre test.

3. 03

   Nous avons choisi

   japicmp dans le profil release : une rupture binaire dans une mineure fait échouer la release ; publication sur Central confirmée à la main.

   Nous avons refusé

   Le SemVer de bonne volonté, et la publication automatique.

   Parce que

   Une release sur Central ne s'efface jamais : une rupture livrée l'est pour toujours.

   Ce que cela vous coûte

   Une rupture volontaire se déclare dans le dépôt pour cette release.

En code

// krizaka-test-support: the producer proves its event matches the JSON Schema its -api publishes
// (events/evt.notification.requested.v1.json, draft 2020-12). A consumer checks its own copy
// against the same file with assertReadable — no shared DTO jar between services.
class NotificationRequestContractTest extends EventContractTest {

  @Test
  void anEmailRequestConforms() {
    assertConforms(NotificationRouting.NOTIFICATION_REQUESTED, 1,
        new NotificationRequest(Channel.EMAIL, "ada@example.com", "welcome", "fr-FR",
            Map.of("name", "Ada")));
  }
}

L'adopter

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.krizaka</groupId>
      <artifactId>krizaka-bom</artifactId>
      <version>0.2.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependency>
  <groupId>com.krizaka</groupId>
  <artifactId>krizaka-test-support</artifactId>
  <scope>test</scope>
</dependency>