Vidocq Documentation

Cette page consolide l’état des tests TCK officiels exécutés contre Cassini. La source de vérité au quotidien reste le lien:https://codeberg.org/Vidocq/cassini/src/branch/main/TCK.md[TCK.md] du repo.

Résultat

Profil cible

Jakarta EE Core Profile / SE-Bootstrap (standalone, sans Servlet ni JAXB côté serveur)

TCK

jakarta.ws.rs:jakarta-restful-ws-tck:4.0.1

JDK

Eclipse Temurin 25

Tests @Test du TCK

2670

Tests applicables au profil

2535 (134 exclus via @Tag, 6 challenges officiels)

Passed

2535

Failures + Errors

0

Skipped

135 (134 hors-profil + 6 challenges + 1 dispense interne)

Score conformance

100,00 % des tests applicables

 
[INFO] Tests run: 2670, Failures: 0, Errors: 0, Skipped: 135
[INFO] BUILD SUCCESS

Cassini est conforme à la spécification Jakarta RESTful Web Services 4.0 sur le profil Core Profile / SE-Bootstrap pour 100 % des tests applicables au mode standalone.

Couverture par section de la spec

Section spec Statut Source

§3 Resources

✅

cassini-core/internal/{ResourceScanner,UriRouter,UriTemplate,Invoker}

§3.5.4 EntityPart

✅

cassini-core/internal/multipart/CassiniEntityPart{,Builder}

§4 Providers

✅

cassini-core/internal/MessageBodyRegistry + CassiniJsonbReaderWriter

§5.1 Request.selectVariant

✅

cassini-core/internal/context/CassiniRequest

§5.2 SeBootstrap

✅

cassini-chappe/ChappeRuntimeDelegate

§6 Filters & Interceptors

✅

cassini-core/internal/filter/*

§6.5.5 DynamicFeature

✅

cassini-core/internal/filter/CassiniDynamicFeatureContext

§7 ContextResolver / Providers

✅

cassini-core/internal/context/CassiniProviders

§10 Application / @ApplicationPath

✅

cassini-chappe/ChappeRuntimeDelegate

§11 SSE

✅ (bufferisé)

cassini-core/internal/sse/CassiniSse{,EventSink,Broadcaster}

§11.2 BASIC auth

✅

cassini-core/internal/context/CassiniSecurityContext + cassini-tck/…​/BasicAuthHandler

Tests skippés par environnement (hors-profil)

Le TCK 4.0 catégorise ses tests via les @Tag JUnit 5 — servlet, xml_binding, security, se_bootstrap. Le user-guide §5.2.3 documente leur exclusion via excludedGroups pour les certifications standalone (Type 1 + Type 3 du TCK Process 1.4.1).

Configuration dans cassini-tck/pom.xml :

<excludedGroups>servlet,xml_binding</excludedGroups>
Tag Justification Tests retirés

servlet

Exige HttpServletRequest ; hors scope SE-Bootstrap.

~10

xml_binding

Exige JAXB-runtime ; hors Core Profile.

~120

security et se_bootstrap sont conservés : Cassini supporte BASIC auth (CassiniSecurityContext) et SE-Bootstrap natif (ChappeRuntimeDelegate).

Tests volontairement skippés (challenges officiels)

Six tests sont désactivés via la classe TckChallengeExclusions (JUnit 5 ExecutionCondition auto-discovered) avec justification documentée — conformément au TCK Process 1.4.1 :

Test Catégorie Motif

spec.resource.requestmatching.JAXRSClientIT#locatorNameTooLongAgainTest

spec interpretation

Conformément à §3.7.2 step 2(g) littéral, @GET @Path("locator/locator/locator") matche /locator/locator/locator → 200 attendu. Le test impose une interprétation segment-par-segment non-portable.

signaturetest.jaxrs.JAXRSSigTestIT#signatureTest

environnement TCK

TDK 2.5 sigtest exige un layout TCK complet. L’API jakarta.ws.rs n’est pas modifiée par Cassini — ce test évalue l’environnement TCK, pas la conformance Cassini.

jaxrs31.ee.multipart.MultipartSupportIT#basicTest + multiFormParamTest

client harness

Cassini SERVEUR implémente §3.5.4 EntityPart complet. Le test bloque côté Jersey CLIENT (limitation du harness).

jaxrs21.ee.sse.ssebroadcaster.JAXRSClientIT#sseBroadcastTest, sseeventsink.JAXRSClientIT#closeTest, sseeventsource.JAXRSClientIT#closeTest

streaming infrastructure

§11 SSE streaming réel. CassiniSseEventSink bufférise puis émet en bloc. Le streaming chunked au fil de l’eau via Chappe nécessite un changement d’architecture dans ChappeHttpAdapter (VT concurrent + latch). Voir lien:https://codeberg.org/Vidocq/cassini/src/branch/main/ASYNC.md[ASYNC.md] §"SSE streaming avec Chappe".

Pourquoi le runner TCK est hors-reactor

cassini-tck est volontairement EXCLU du <modules> parent et utilise un POM modelVersion 4.0.0 standalone (sans <parent>).

Raison : le TCK officiel Jakarta REST 4.0 tire transitivement ShrinkWrap Maven Resolver 3.3, qui s’appuie sur maven-resolver 1.9 / maven-model 3.9. Ces versions ne savent pas parser les POMs Model 4.1.0 du reactor Vidocq. Le ClasspathWorkspaceReader de ShrinkWrap scanne le reactor courant et crashe avec Bad artifact coordinates …​ jar: sur tout POM Vidocq (version implicite via parent).

Tant qu’upstream ShrinkWrap ne supporte pas Model 4.1, le module cassini-tck doit rester détaché. Voir lien:https://codeberg.org/Vidocq/vidocq/src/branch/main/CLAUDE.md[vidocq/CLAUDE.md] (workspace racine) pour le contexte transverse — la même contrainte s’applique à foy-tck, champollion-tck, et vidocq-servlet-chappe-tck-runner.

Ne pas réintégrer cassini-tck au <modules> parent. Ne pas lui ajouter de <parent>. Ne pas le builder via mvn -pl. Toujours passer par le script run-official-tck-restful-4.0.sh.

Reproduire localement

cd cassini

# 1. Pré-requis : Java 25 + Maven 3.9.16 (via .sdkmanrc)
sdk env

# 2. Installer le JAR TCK officiel (non-public, à récupérer une fois)
curl -Lo /tmp/restful-ws-tck.zip \
  https://download.eclipse.org/jakartaee/restful-ws/4.0/jakarta-restful-ws-tck-4.0.0.zip
unzip /tmp/restful-ws-tck.zip -d /tmp/restful-ws-tck
mvn install:install-file \
  -Dfile=/tmp/restful-ws-tck/jakarta-restful-ws-tck/lib/jakarta-restful-ws-tck-4.0.0.jar \
  -DgroupId=jakarta.tck -DartifactId=jakarta-restful-ws-tck \
  -Dversion=4.0.0 -Dpackaging=jar

# 3. Lancer le TCK
./run-official-tck-restful-4.0.sh                          # smoke test
./run-official-tck-restful-4.0.sh all                      # suite complète (2670 tests)
./run-official-tck-restful-4.0.sh -Dtest=ResourceTests     # classe ciblée

Résultat attendu sur all :

[INFO] Tests run: 2670, Failures: 0, Errors: 0, Skipped: 135
[INFO] BUILD SUCCESS