affaan-m/quarkus-tdd

Quarkus 3.x LTS 的测试驱动开发，使用 JUnit 5、Mockito、REST Assured、Camel 测试和 JaCoCo。在添加功能、修复 bug 或重构事件驱动服务时使用。

编程协作开发 Agent Agent 技能调研测试驱动开发 Quarkus 单元测试 REST 集成测试事件驱动测试代码覆盖率统计

技术栈: cursor24万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

Flujo de Trabajo TDD en Quarkus

Orientación TDD para servicios Quarkus 3.x con 80%+ de cobertura (unit + integración). Optimizado para arquitecturas orientadas a eventos con Apache Camel.

Cuándo Usar

Nuevas funcionalidades o endpoints REST
Correcciones de bugs o refactorizaciones
Agregar lógica de acceso a datos, reglas de seguridad o streams reactivos
Probar rutas Apache Camel y manejadores de eventos
Probar servicios orientados a eventos con RabbitMQ
Probar lógica de flujo condicional
Validar operaciones asíncronas con CompletableFuture
Probar propagación de LogContext

Flujo de Trabajo

Escribir pruebas primero (deben fallar)
Implementar el código mínimo para que pasen
Refactorizar con pruebas en verde
Exigir cobertura con JaCoCo (objetivo 80%+)

Pruebas Unitarias con Organización @Nested

@ExtendWith(MockitoExtension.class)
@DisplayName("Pruebas Unitarias de OrderService")
class OrderServiceTest {

  @Mock
  private OrderRepository orderRepository;

  @Mock
  private EventService eventService;

  @Mock
  private FulfillmentPublisher fulfillmentPublisher;

  @InjectMocks
  private OrderService orderService;

  private CreateOrder…

以下为摘要预览，完整内容请查看 GitHub 原文。

Quarkus 中的 TDD 工作流

面向 Quarkus 3.x 服务的 TDD 指南，覆盖率（单元 + 集成）需达到 80%+。针对使用 Apache Camel 的事件驱动架构进行了优化。

适用场景

新功能或 REST 端点
Bug 修复或重构
添加数据访问逻辑、安全规则或响应式流
测试 Apache Camel 路由和事件处理器
测试使用 RabbitMQ 的事件驱动服务
测试条件流程逻辑
验证使用 CompletableFuture 的异步操作
测试 LogContext 传递

工作流

先编写测试（必须失败）
实现最少量代码使其通过
在测试全绿的情况下重构
通过 JaCoCo 强制覆盖率（目标 80%+）

使用 @Nested 组织的单元测试

@ExtendWith(MockitoExtension.class)
@DisplayName("OrderService 单元测试")
class OrderServiceTest {

  @Mock
  private OrderRepository orderRepository;

  @Mock
  private EventService eventService;

  @Mock
  private FulfillmentPublisher fulfillmentPublisher;

  @InjectMocks
  private OrderService orderService;

  private CreateOrderCommand validCommand;

  @BeforeEach
  void setUp() {
    validCommand = new CreateOrderCommand(
        "customer-123",
        List.of(new OrderLine("sku-123", 2))
    );
  }

  @Nested
  @DisplayName("createOrder 测试")
  class CreateOrder {

    @Test
    @DisplayName("应持久化订单并发布 fulfillment 事件")
    void givenValidCommand_whenCreateOrder_thenPersistsAndPublishes() {
      // ARRANGE
      doNothing().when(orderRepository).persist(any(Order.class));

      // ACT
      OrderRecei…

重要提示：源文件不在本站托管，请通过 GitHub 查看与下载。

索引更新于 8/25/2026, 9:18:05 PMGitHub ↗

SKILL.md14.1 KB在 GitHub 查看 ↗