Vidocq Documentation

vidocq-runtime-examples regroupe les applications de démonstration utilisées comme oracles vivants pour la validation et la documentation. Chaque exemple est un module Maven indépendant, packageable via le vidocq-runtime-maven-plugin.

Coordonnées

Reactor

vidocq-runtime-examples/

Build

cd vidocq-runtime-examples/<exemple> && ./mvnw -ntp package

Catalogue

Exemple Description

vidocq-runtime-cassini-rest-example

Application REST minimale — une ressource Jakarta REST, packageable en jlink/jpackage/docker. Sert de référence canonique pour tester le plugin Maven et le mécanisme d’extensions sur le triptyque Chappe + Vauban + Cassini.

vidocq-runtime-mansart-h2-example

Application complète REST + CDI + persistence via Mansart sur H2 in-memory. Démontre @Transactional, Repository<T, ID>, @Inject constructor injection. C’est l’exemple recommandé dans Démarrage rapide.

vidocq-runtime-external-rest-lib

Bibliothèque externe consommée par les exemples — illustre le mode où une dépendance JPMS-nommée fournit ses propres beans CDI. Utile pour valider la composition multi-module APT.

vidocq-runtime-cassini-rest-example — quick start

cd vidocq-runtime-examples/vidocq-runtime-cassini-rest-example
./mvnw -ntp package -DskipTests

# image jlink autonome
./target/dist/bin/todo-app

# interface UI sur http://127.0.0.1:8080/
# API sur http://127.0.0.1:8080/api/todos

vidocq-runtime-mansart-h2-example — quick start

cd vidocq-runtime-examples/vidocq-runtime-mansart-h2-example
./mvnw -ntp package
java -jar target/*-runner.jar

curl -X POST http://localhost:8080/api/products \
     -H 'Content-Type: application/json' \
     -d '{"name":"câbles","price":12.50}'

curl http://localhost:8080/api/products

L’exemple démontre le scope @TransactionScoped et le bridge transactionnel Mansart. Il a aussi servi de banc de reproduction pour le bug VAU-INJ-001 (résolution proxy normal-scope) — voir vidocq/VAUBAN-BUGS.md.

Pour aller plus loin