# CUI Java CDI 技能 CUI 项目中 CDI 和 Quarkus 开发的标准和模式。该技能提供了有关 CDI 依赖项注入、Quarkus 容器配置、测试实践和本机映像优化的全面指导。 ## 工作流程 ### 第 1 步：加载基础 Java 模式 **关键**：首先加载基础 Java 开发模式。技能：cui-java-core cui-java-core 技能提供了 CDI 构建的基本基础模式，包括构造函数注入、依赖项管理、空安全、不变性、异常处理和现代 Java 功能。这些核心 Java 模式是 CDI 特定开发的先决条件。 ### 第 2 步：加载适用的 CDI 标准 **关键**：加载当前的 CDI 标准以用作执行标准。 1. **始终加载基础 CDI 标准**：阅读：standards/cdi-aspects.md 阅读：standards/cdi-container.md 它们提供了开发始终需要的核心 CDI 模式和容器配置。 2. **基于上下文的条件加载** : * 如果编写 CDI 单元测试：阅读：standards/cdi-testing.md * 如果编写集成测试或设置集成测试基础设施：阅读：标准/集成测试.md * 如果使用反射注册模式和本机图像要求：阅读：standards/quarkus-reflection.md * 如果执行本机优化或系统反射优化：阅读：standards/quarkus-native.md * 如果实施安全功能或安全测试：阅读：standards/cdi-security.md 3. **从所有加载的标准中提取关键要求** 4. **存储在工作内存中**以供任务执行期间使用 ### 步骤 3：分析现有 CDI 代码 **何时执行** ：加载标准后 **分析什么**： 1. **依赖注入模式**： * 验证构造函数注入使用情况（禁止字段注入） * 检查`@Inject`注释的使用是否正确 * 验证 CDI bean 范围（`@ApplicationScoped`、`@RequestScoped` 等） *审查生产者方法及其范围配置 2. **CDI 组件结构** : * 识别 CDI bean 及其依赖项 * 检查循环依赖 * 验证可选依赖项“Instance”的正确使用 * 检查限定符的使用和不明确的依赖关系解析 3. **容器配置**（如果适用）： * 检查 Dockerfile 和基础镜像选择 * 验证安全强化（OWASP合规性） * 检查证书管理方法（PEM 与 PKCS12） * 验证健康检查的实施 4. **测试配置**（如果测试上下文）： * 回顾 `@QuarkusTest` 与 `@QuarkusIntegrationTest` 的用法 * 检查JaCoCo覆盖配置 * 验证测试配置文件和配置覆盖 * 验证测试资源配置 5. **集成测试设置**（如果集成测试上下文）： * 验证基于脚本的生命周期管理（启动/停止脚本） * 检查本机构建的 Maven 配置文件配置 * 查看 Docker Compose 配置 * 验证 HTTPS 和证书设置 * 确保仅 API 测试（集成测试中无 CDI 注入） 6. **本机优化**（如果本机上下文）： * 分析反射注册模式 * 查看`@RegisterForReflection`注释 * 检查部署处理器配置（ReflectiveClassBuildItem） *验证CDI bean的AdditionalBeanBuildItem使用情况 * 识别优化机会 7. **安全配置**（如果安全上下文）： * 验证安全依赖注入模式 * 启动时检查安全配置验证 *审查安全日志记录实践（无敏感数据日志记录） * 验证安全测试覆盖范围 * 确保运行时安全强化（OWASP合规性） ### 步骤 4：将 CDI 标准应用于开发任务 **何时执行** ：在实施或代码审查期间 **申请什么**： 1. **构造函数注入标准**： * 将任何字段注入转换为构造函数注入 * 将注入的字段设置为“final” * 删除单构造 bean 中不必要的“@Inject” * 当存在多个构造函数时，添加`@Inject`来纠正构造函数 2. **CDI 范围选择**： * 将`@ApplicationScoped`应用于无状态服务 * 使用`@RequestScoped`来获取特定于请求的数据 * 除非需要急于初始化，否则避免使用`@Singleton` * 验证范围是否符合生命周期要求 3. **生产者方法模式**： * 对可能返回 null 的生产者使用“@Dependent”范围 * 确保正常范围的生产者永远不会返回 null * 在生产者中更喜欢 `Instance` 而不是 `Optional` * 在适当的时候实现空对象模式 4. **容器安全**（如果是容器上下文）： * 使用 distroless 基础镜像进行生产 * 实施内部健康检查（无curl/wget） * 配置OWASP安全强化 * 设置具有适当权限的 PEM 证书 5. **测试实践**（如果测试上下文）： * 为 Quarkus 正确配置 JaCoCo * 使用`@QuarkusTest`进行CDI注入测试 * 确保Surefire配置中的`@{argLine}` * 实现不同场景的测试配置文件 6. **集成测试设置**（如果集成测试上下文）： * 配置 Maven 配置文件单次执行（避免重复构建） * 实现基于脚本的生命周期（启动/停止容器） * 使用 RestAssured 进行仅 API 测试（无“@Inject”） * 使用自签名证书配置 HTTPS * 设置外部端口映射（10443:8443） * 确保生产等效的 Docker Compose 配置 7. **本机优化**（如果本机上下文）： * 对应用程序级类使用`@RegisterForReflection` * 对基础设施类使用`ReflectiveClassBuildItem` * 对 CDI beans 使用`AdditionalBeanBuildItem`（不是反射） * 将反映范围最小化到实际需求 * 使用类型安全的类引用（不是字符串） * 避免双重注册（注释+构建步骤） 8. **安全实施**（如果是安全上下文）： * 在启动时实现安全配置验证 * 使用构造函数注入来实现安全依赖 * 实施安全日志记录（屏蔽敏感数据） * 添加安全单元和集成测试 * 验证仅 HTTPS 强制执行 * 配置运行时安全强化 ### 步骤 5：验证实施质量 **何时执行**：应用标准后 **质量检查**： 1. **CDI 模式验证** : * 所有依赖都使用构造函数注入 * 所有注入的字段都是“final” * 应用适当的 CDI 范围 * 不存在场地或二传手注入 * 生产者方法遵循范围规则 2. **测试验证**（如果测试上下文）： * JaCoCo正确配置 * 成功收集测试覆盖率 * 测试配置文件配置是否正确 * 所有 CDI 组件均经过测试 3. **集成测试验证**（如果集成测试上下文）： * Maven 配置文件配置为单次执行 * 基于脚本的生命周期脚本存在并且可以工作 * Docker Compose 使用与生产等效的配置 * 测试使用仅 API 方法（无 CDI 注入） * HTTPS配置了证书 * 端口映射正确（外部10443，内部8443） 4. **容器验证**（如果是容器上下文）： * 使用 Distroless 基础镜像 * 应用安全强化 * 正确实施健康检查 * 证书配置适当的权限 5. **本机优化验证**（如果本机上下文）： * 反射注册优化和选择性 * 无需双重注册（注释+构建步骤） * CDI beans使用AdditionalBeanBuildItem * 使用类型安全的类引用 * 原生编译成功 * 测试在本机模式下通过 * 维持或改进绩效指标 6. **安全验证**（如果是安全上下文）： * 启动时安全配置验证 * 没有记录敏感数据 * 安全测试覆盖率100% * 仅 HTTPS 强制执行已验证 * 应用运行时安全强化 7. **编译和构建**： # 编译模块任务： subagent_type：maven-builder 描述：编译模块提示： | 编译模块以验证更改。参数： - 命令：干净编译 - 模块：[模块名称] 关键：等待完成。修复所有编译错误。 # 运行测试任务： subagent_type：maven-builder 描述：运行测试提示： | 运行模块测试。参数： - 命令：干净测试 - 模块：[模块名称] 关键：等待完成。修复任何测试失败。 # 质量验证任务： subagent_type：maven-builder 描述：质量验证提示： | 运行预提交质量检查。参数： - 命令：-Ppre-commit clean verify -DskipTests - 模块：[模块名称] 关键：等待完成。解决所有质量问题。 # 最终验证任务： subagent_type：maven-builder 描述：最终验证提示： | 运行最终构建并安装。参数： - 命令：全新安装 - 模块：[模块名称] 关键：等待完成。确保所有测试和质量检查通过。 8. **本机构建**（如果本机上下文）： # 原生编译任务： subagent_type：maven-builder 描述：本机构建提示： | 构建本机可执行文件。参数： - 命令：清理包 -Dnative - 模块：[模块名称] 关键：等待完成（可能需要几分钟）。记录构建时间和可执行文件大小。 ### 第 6 步：记录更改并提交 **何时执行** : 验证通过后 **文档更新**： * 如果 CDI 架构发生变化，请更新模块自述文件 * 记录任何特殊配置要求 * 注明与标准的任何偏差并说明理由 * 包括绩效指标（如果适用） **提交标准**： * 遵循标准提交消息格式 * 参考相关问题或任务 * 如果迁移代码，请包含“已验证零信息丢失” * 添加 Claude Code 的共同创作行 ## 常见模式和错误预防有关详细的 CDI 模式和故障排除，请参阅加载的标准文件： * **CDI 模式** ：构造函数注入、可选依赖项、生成器方法 - 请参阅“standards/cdi-aspects.md” * **CDI 测试** ：JaCoCo 配置、测试配置文件、覆盖率要求 - 请参阅 `standards/cdi-testing.md` * **集成测试**：仅 API 测试、基于脚本的生命周期、Maven 配置文件 - 请参阅 `standards/integration-testing.md` * **容器配置**：Docker、健康检查、证书、OWASP 安全 - 请参阅 `standards/cdi-container.md` * **反射标准** ：注册模式、AdditionalBeanBuildItem、自动注册 - 请参阅 `standards/quarkus-reflection.md` * **原生优化流程**：系统优化工作流程、阶段、验证 - 请参阅 `standards/quarkus-native.md` * **安全模式**：安全配置、安全日志记录、安全测试 - 请参阅“standards/cdi-security.md” ## 质量验证所有更改必须通过： * 专用构造函数注入 * 所有注入的字段都是“final” * 应用适当的 CDI 范围 * 生产者方法遵循范围规则 * 测试通过并收集了覆盖率 * 集成测试使用仅 API 方法（如果适用） * 反射注册优化（如果适用） * 启动时的安全验证（如果适用） * 不记录敏感数据（始终） * 质量检查通过（`-Ppre-commit`） * 原生编译成功（如果适用） ## 参考文献 ### 核心 CDI 和 Quarkus * CDI 2.0 规范： * Quarkus CDI 指南： * Quarkus CDI 参考： ### 测试 * Quarkus 测试指南： * JUnit 5 用户指南： * REST Assured 文档： * Maven 故障安全插件： * JaCoCo 文档： ### 原生编译 * Quarkus 原生指南： * Quarkus 扩展开发： * GraalVM 本机图像反射： ### 容器安全 * Docker 安全最佳实践： * OWASP Docker 前 10 名： * NIST 容器安全指南： * CIS Docker 基准测试： ### 应用程序安全 * OWASP 前 10 名： * Quarkus 安全指南：

崔Java CDi

包含技能