Vidocq Documentation

Vidocq est une suite de runtimes Jakarta EE et MicroProfile écrite en Java 25 pur, natif Java Modules, fondée sur la génération de code statique (Class-File API + APT) et les virtual threads.

Nouveau ici ? Le guide de démarrage rapide vous mène de l’installation de la CLI à un service REST qui tourne en quelques minutes, et le tutoriel première app du blog raconte le même parcours pas à pas.

L’écosystème en un diagramme

Diagram

Chaque module est un projet indépendant, publié séparément, avec son propre cycle de vie. Vidocq Runtime les assemble via une SPI d’extensions inspirée de Quarkus.

Pourquoi un nouveau runtime ?

Trois raisons :

  1. Souveraineté technique. Le monde Jakarta repose largement sur quelques fondations historiques (Tomcat, Jetty, Netty, Hibernate, Yasson, ArC, RESTEasy). Travail remarquable, dépendances accumulées. Vidocq prend le pari de tout réimplémenter sur Java 25 pur, en s’appuyant sur ce que la JDK propose désormais : virtual threads, scoped values, Class-File API, Java Modules strict.

  2. Génération à la compilation. Pas de réflexion à chaud, pas de proxy dynamique, pas d’ASM, pas de Byte Buddy. Tout ce qu’on peut calculer à compile-time est calculé à compile-time. Au démarrage, on instancie. Compatible AOT (GraalVM native-image, Project Leyden CDS).

  3. Inspiration historique sobre. Chaque composant rend hommage à une figure française de la fin XVIIIᵉ / début XIXᵉ siècle dont la méthode résume l’esprit du module. C’est un parti-pris esthétique, pas un pastiche.

Les composants

Composant Rôle Repo

Vidocq Runtime

Serveur d’application MicroProfile, orchestrateur d’extensions

https://codeberg.org/Vidocq/vidocq

Vauban

Container CDI 4.1 Lite, build-time, natif Java Modules

https://codeberg.org/Vidocq/vauban

Cassini

Implémentation Jakarta REST 4.0 / JAX-RS

https://codeberg.org/Vidocq/cassini

Champollion

Implémentation Jakarta JSON-P 2.1 + JSON-B 3.0

https://codeberg.org/Vidocq/champollion

Chappe

Serveur HTTP/1.1 + HTTP/2 (HTTP/3 en chantier), virtual threads, zéro dépendance

https://codeberg.org/Vidocq/chappe

Foy

Implémentation Jakarta Servlet 6.1

https://codeberg.org/Vidocq/foy

Ravel

Implémentation MicroProfile Config 3.1

https://codeberg.org/Vidocq/ravel

Knock

Implémentation MicroProfile Health 4.0

https://codeberg.org/Vidocq/knock

Dirac

Implémentation MicroProfile Metrics 5.1

https://codeberg.org/Vidocq/dirac

Heisenberg

Implémentation MicroProfile Fault Tolerance 4.1

https://codeberg.org/Vidocq/heisenberg

Cervantes

Implémentation MicroProfile JWT 2.1

https://codeberg.org/Vidocq/cervantes

Cyrano

Implémentation MicroProfile Rest Client 4.0

https://codeberg.org/Vidocq/cyrano

Humboldt

Implémentation MicroProfile Telemetry 2.1

https://codeberg.org/Vidocq/humboldt

Grimm

Implémentation MicroProfile OpenAPI 4.1

https://codeberg.org/Vidocq/grimm

Mansart

Jakarta Data 1.0 + Jakarta Persistence 3.2 (M7 en attente)

https://codeberg.org/Vidocq/mansart

Pages transverses

  • Architecture globale — frontières des modules, matrice de dépendances, choix transverses (zéro-dépendance, Java Modules, codegen, virtual threads).

  • Comparatif — Vidocq Runtime face à Quarkus, Helidon SE 4 et Spring Boot 4.

  • Roadmap consolidée — statut par module et jalons proches (M2x, M5, M6c, M7).

Statut

La suite est publiée en 0.2.x sur Maven Central — une alpha : les API peuvent encore évoluer et l’usage en production n’est pas encore recommandé. Les retours des premiers utilisateurs sont très bienvenus sur Codeberg.

Ce qui marche aujourd’hui :

  • Chappe — HTTP/1.1, HTTP/2, virtual threads, conformance RFC 9110/9112/9113.

  • Vauban — CDI 4.1 Lite build-time, plugin Maven, intégration JUnit.

  • Cassini — REST 4.0, intégration TCK partielle (voir cassini/cassini-migration.md).

  • Champollion — JSON-P 2.1 + JSON-B 3.0, génération APT, suites TCK partielles (voir champollion/JSON-ROADMAP.md).

  • Foy — Servlet 6.1, intégration TCK partielle.

  • Vidocq — orchestrateur initial avec extensions Mansart H2 + transactions.

  • MicroProfile — Config (Ravel), Health (Knock), Metrics (Dirac), Fault Tolerance (Heisenberg), JWT (Cervantes), Rest Client (Cyrano), Telemetry (Humboldt), OpenAPI (Grimm), chacun câblé dans Vidocq Runtime via une extension.

Ce qui est en chantier :

  • Mansart — Jakarta Data 1.0 SPI, JPA 3.2 en plan.

  • WebSocket — Chappe + Foy.

  • HTTP/3 / QUIC — Chappe.

  • MicroProfile — durcissement TCK et intégration transverse dans Vidocq Runtime.

Détail complet par module : Roadmap consolidée.

Liens utiles