用途:在 Quarkus REST/JAX-RS 上构建 ddd4j 的 REST 端点,并在请求开始时绑定 ddd4j 请求上下文;同时定义 HTTP 契约(端点、状态码、载荷、稳定错误响应),配置生产控制项(校验、认证钩子、基于共享 CAS 的幂等、显式 CORS、请求限制),区分存活与就绪探针,并用 QuarkusTest 覆盖正常、错误、重放与异步路径。
主要能力:覆盖 Quarkus REST/JAX-RS、请求上下文、错误、认证、校验、幂等、CORS、就绪检查;强调 CDI/Arc、构建期与运行期边界、原生镜像边界,以及 3.3.x 与 4.0.x 两条维护线各自的 ddd4j/JDK/Maven/POM/Quarkus 契约(4.0.x 是适配器线名,不代表 Quarkus Platform 4)。
使用方式:先通过 ddd4j-quarkus-version-selection 确定维护线,再定位 ddd4j-quarkus-web、web-quarkus 与 HTTP 测试;用 Quarkus REST 过滤器/拦截器在请求开始绑定上下文,并在成功、异常与异步完成时释放;随后配置生产控制项并运行 QuarkusTest,必要时验证原生模式;最后输出端点清单、配置键、测试证据与风险。
适用场景:Quarkus 上的 ddd4j REST 端点开发、HTTP 契约定义、生产控制配置、就绪检查设计、HTTP 路径测试与既有 Web 层评审。
限制:不适用于 Spring MVC/WebMvc(改用 ddd4j-boot-web)、Javalin(ddd4j-javalin-web)、Spring Cloud 网关(ddd4j-cloud-web)、命令/查询契约(ddd4j-core)、认证机制选型(ddd4j-quarkus-auth),也不适用于非 ddd4j 的普通 Quarkus REST。注意 Quarkus REST 与 Spring MVC 语义不可直接迁移;上下文须在错误与异步路径释放;幂等键须跨实例共享;就绪与存活不可混淆;原生镜像需显式注册反射;CORS 与请求限制须显式配置。输入不足时输出 missing 提示,不编造 API。本技能不访问、不收集、不存储、不传输用户数据、凭据或密钥。