.claude/skills/ └── java-unit-test/

mkdir -p .claude/skills/java-unit-test

--- 

name: java-unit-test description: 为 Java 项目生成自动化单元测试，基于 JUnit 5 和 Mockito 框架。

 当用户要求编写单元测试、测试用例或进行测试覆盖时使用。 

allowed-tools: Read, Bash version: 1.0.0 —

 触发条件 （说明什么情况下激活此技能） 
前置检查清单
 
（在生成测试前必须执行的检查）
 
测试代码生成规范
 
（详细的代码生成规则）
 
测试用例设计原则
 
（测试覆盖策略、场景设计）
 
**实践清单
 
（命名、结构、断言等规范）
 
常见问题与解决方案
 
（边界情况、错误处理）

 触发条件 
当用户提出以下需求时激活此技能：
 
   
     
     
 
      
“帮我写单元测试”
 
      
“生成测试用例”
 
      
“为这个类写测试”
 
      
“测试覆盖率”
 
      
“单元测试”
 
      
“junit test”
 
      
“mockito test”
 
     

 前置检查清单 
在生成测试代码前，必须执行以下检查：
 
1. 识别被测类
 
   
     
     
 
      
读取用户提供的 Java 源文件
 
      
如果未提供，询问用户提供被测类的完整路径
 
     
 
2. 分析类结构
 
   
     
     
 
      
识别所有 public 方法（包括构造方法）
 
      
记录方法的参数、返回值类型、异常声明
 
      
识别依赖的其他类（用于 Mock）
 
     
 
3. 确定测试框架
 
   
     
     
 
      
默认使用 JUnit 5 (Jupiter)
 
      
Mock 框架使用 Mockito 3.x 或更高版本
 
     

 测试类命名规范 
测试类名称：[被测类名]Test.java
 
// 示例 被测类：UserService.java 测试类：UserServiceTest.java

// 1. JUnit 5 核心导入 import org.junit.jupiter.api.; import static org.junit.jupiter.api.Assertions.; 
// 2. Mockito 导入 import org.mockito.Mock; import org.mockito.InjectMocks; import static org.mockito.Mockito.; import static org.mockito.ArgumentMatchers.;
 
// 3. 被测类导入 import com.yourpackage.UserService;
 
// 4. 其他依赖导入 import java.util.List;

@ExtendWith(MockitoExtension.class) @DisplayName(“UserService 单元测试”) class UserServiceTest 
@AfterEach void tearDown() { // 清理资源 } // ========== 测试方法 ========== @Test @DisplayName("创建用户 - 成功场景") void createUser_Success() @Test @DisplayName("创建用户 - 邮箱已存在抛出异常") void createUser_EmailAlreadyExists_ThrowsException() 
 
}

 常用 Mock 方法 
// 返回指定值 when(mock.someMethod(anyString())).thenReturn(“result”);
 
// 抛出异常 when(mock.someMethod(anyString())).thenThrow(new RuntimeException());
 
// 链式调用 when(mock.someMethod())
 
.thenReturn("first") .thenReturn("second") .thenThrow(new Exception()); 
 
// 真实调用（部分 mock） when(mock.someMethod()).thenCallRealMethod();
 
// 无返回值方法 doNothing().when(mock).voidMethod(anyString());
 
// 抛出异常（void 方法） doThrow(new RuntimeException()).when(mock).voidMethod();
 
// 按参数类型匹配 when(mock.method(anyString(), anyInt())).thenReturn(result); when(mock.method(eq(“specific”), anyInt())).thenReturn(result);

// 验证调用次数 verify(mock).someMethod(); // 调用 1 次 verify(mock, times(2)).someMethod(); // 调用 2 次 verify(mock, never()).someMethod(); // 从未调用 verify(mock, atLeastOnce()).someMethod(); // 至少调用 1 次 verify(mock, atMost(3)).someMethod(); // 最多调用 3 次 
// 验证调用顺序 InOrder inOrder = inOrder(mock1, mock2); inOrder.verify(mock1).firstMethod(); inOrder.verify(mock2).secondMethod();
 
// 验证参数 verify(mock).someMethod(eq(“specific”)); verify(mock).someMethod(argThat(argument -> argument.length() > 5));

// 如果被测类有 Builder User user = User.builder() 
.id(1L) .email("") .password("encodedPassword") .status(UserStatus.ACTIVE) .build(); 
 
// 或者使用测试专用的 Builder User user = TestUserBuilder.aUser()
 
.withId(1L) .withEmail("") .build();

User user = new User(); 

user.setId(1L); user.setEmail(“”); user.setPassword(“encodedPassword”); user.setStatus(UserStatus.ACTIVE);

@Test void createUser_WithValidData_Success() { } 
@Test void createUser_WithDuplicateEmail_ThrowsException() { }
 
@Test void createUser_WithNullEmail_ThrowsException() { }
 
@Test void createUser_WithEmptyPassword_ThrowsException() { }

/ 
 / E2E Tests (少量) /____ / Integration Tests (适量) /________ 
 
/ Unit Tests (大量) /____________

帮我为 UserService.java 写单元测试

/java-unit-test

@Service public class UserService 
 if (userRepository.existsByEmail(userDTO.getEmail())) { throw new UserAlreadyExistsException("邮箱已存在"); } User user = new User(); user.setEmail(userDTO.getEmail()); user.setPassword(passwordEncoder.encode(userDTO.getPassword())); User savedUser = userRepository.save(user); emailService.sendWelcomeEmail(user.getEmail()); return savedUser.getId(); } public User getUserById(Long id) return userRepository.findById(id) .orElseThrow(() -> new UserNotFoundException("用户不存在")); } public List 
     
       
       
         getAllUsers() { return userRepository.findAll(); } 
       
 
}

@ExtendWith(MockitoExtension.class) @DisplayName(“UserService 单元测试”) class UserServiceTest 
@Test @DisplayName("创建用户 - 邮箱已存在抛出异常") void createUser_EmailAlreadyExists_ThrowsException() @Test @DisplayName("创建用户 - 参数为空抛出异常") void createUser_NullParameter_ThrowsException() @Test @DisplayName("根据 ID 获取用户 - 成功场景") void getUserById_Success() @Test @DisplayName("根据 ID 获取用户 - 用户不存在抛出异常") void getUserById_UserNotFound_ThrowsException() @Test @DisplayName("获取所有用户 - 返回空列表") void getAllUsers_ReturnsEmptyList() @Test @DisplayName("获取所有用户 - 返回用户列表") void getAllUsers_ReturnsUserList() 
 
}

@ParameterizedTest @DisplayName(“密码强度校验”) @MethodSource(“providePasswords”) void validatePassword_PasswordStrength(String password, boolean expected) { 
boolean result = userService.validatePassword(password); assertEquals(expected, result); 
 
}
 
private static Stream 
      
        providePasswords() { 
      
 
return Stream.of( Arguments.of("weak", false), Arguments.of("Strong123!", true), Arguments.of("TooShort1", false), Arguments.of("NoNumberHere!", false) ); 
 
}

@ExtendWith(MockitoExtension.class) class StaticMethodTest { 
@Test void mockStaticMethod() { try (MockedStatic 
     
       
       
         mocked = mockStatic(StringUtils.class)) { mocked.when(() -> StringUtils.isEmpty(anyString())).thenReturn(true); boolean result = StringUtils.isEmpty("test"); assertTrue(result); } } 
       
 
}

// 在 src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker 
内容：
 
mock-maker-inline

@Test void testPrivateMethod() throws Exception 

git add .claude/skills/java-unit-test/ git commit -m “feat: 添加 Java 单元测试自动化 Skill” git push