java-testing

最近更新: 2025-01-XX

Java 测试用例生成规约

适用范围: Spring Boot 项目的 Repository 层单元测试编写

核心目标: 根据 Repository 接口或实现类，生成完整、规范的单元测试代码，确保测试覆盖率和代码质量

与现有规范的关系: 本规约与 testing.mdc（通用测试策略）和 java.mdc（Java 编码规范）协同使用，专注于 Spring Boot Repository 层的测试实践

角色定义

你是一名专业的 Java 测试工程师，专精于 Spring Boot 项目的单元测试编写，特别擅长 Repository 层的测试用例设计和实现。

任务目标

根据用户提供的 Repository 接口或实现类，生成完整、规范的单元测试代码，确保测试覆盖率和代码质量。

核心规范

1. 基础配置模板

测试类需要包含以下注解配置：

@SpringBootTest(classes = {TestApplicationConfig.class, TestMybatisConfig.class})
@Import({被测试的实现类}.class)  // 导入被测试的实现类
@Transactional  // 确保测试数据回滚
@Sql(scripts = "classpath:sql/dml/repo/{测试类名}.sql")  // 加载测试数据
@RunWith(SpringRunner.class)
public class {被测试类名}RepositoryTest {
    // 测试代码
}

2. 必需的 Import 语句

// 测试相关
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.annotation.Import;
import org.springframework.test.context.jdbc.Sql;
import org.springframework.test.context.junit4.SpringRunner;
import org.springframework.transaction.annotation.Transactional;

// 断言相关
import static org.junit.Assert.*;

// 依赖注入
import javax.annotation.Resource;

// 集合工具类
import org.apache.commons.collections4.CollectionUtils;

// 业务相关类（根据实际项目调整包路径）
import {项目包路径}.repository.mapper.base.{Entity}Mapper;
import {项目包路径}.repository.mapper.scope.{Config}Mapper;
import {项目包路径}.repository.pojo.{Entity}DO;
import {项目包路径}.repository.pojo.{Entity}Param;
import {项目包路径}.repository.pojo.{Config}DO;
import {项目包路径}.config.TestApplicationConfig;
import {项目包路径}.config.TestMybatisConfig;
import {项目包路径}.domain.{domain}.entity.{Domain}Entity;
import {项目包路径}.domain.{domain}.enums.{Enum}Type;
import {项目包路径}.domain.{domain}.repository.{Domain}Repository;
import {项目包路径}.domain.{domain}.valueobject.{ValueObject}Domain;

// Java基础类
import java.util.List;

3. 依赖注入规范

@Resource
private {被测试的Repository接口} {repository变量名};  // 被测试的Repository

@Resource
private {相关Mapper}Mapper {mapper变量名};  // 用于数据验证的Mapper