用途:在 ddd4j 与 Javalin 组合的项目中,统一处理 Web 层行为,包括路由、Request/Trace/Tenant Context、错误与异常映射、CORS、认证接入、校验、幂等、请求限制、异步超时和健康检查。适用于 Javalin 6.7.x、7.1.x、7.2.x 三条维护线。
主要能力:在请求开始时绑定 Request/Trace/Tenant Context,并在成功、异常和异步完成时恢复;显式配置 CORS 的 origins、credentials、headers、methods;为写接口实现幂等(多实例生产需共享 CAS);提供区分存活与就绪的健康端点,就绪状态基于真实依赖。
使用方式:先用 ddd4j-javalin-version-selection 确认维护线,再定位当前检出中的 web 模块、web-testkit 路径与 HTTP 契约测试。先通过 web-testkit 定义路由、状态码、载荷和错误响应,再实现处理器。随后配置 CORS、校验、幂等、限流与异步超时,最后用正常、错误、重放和异步契约测试验证。安装命令:npx skills add full-stack-skills/ddd4j-skills --skill ddd4j-javalin-web。
适用场景:Javalin 路由与错误映射、Context 绑定与恢复、生产 CORS 配置、写接口幂等、存活/就绪端点设计。
限制:认证框架、令牌校验与角色映射应使用 ddd4j-javalin-auth;健康状态来源应使用 ddd4j-javalin-runtime;核心 SPI 类型应使用 ddd4j-core;跨能力评审或发布门禁应使用 ddd4j-javalin-production-hardening;Spring Boot、Quarkus、Spring Cloud 应使用对应技能;无 ddd4j 的普通 Javalin 项目不适用。anyHost() 不得进入生产;Caffeine 幂等仅为单实例回退;冒烟测试返回 200 不能证明路由、认证或数据库行为。输入缺失时输出 missing 提示并继续只读检查。本技能不访问、收集、存储或传输用户数据、凭据或密钥。