package com.dne.ems.validation;

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 密码验证注解，用于标记需要进行密码规则验证的字段
 * 
 * <p>使用此注解的字段将由{@link PasswordValidator}进行验证，
 * 确保密码符合系统的安全要求：至少8个字符长，包含大小写字母、数字和特殊字符。</p>
 * 
 * <p>示例用法：</p>
 * <pre>
 * public class UserDto {
 *     @ValidPassword
 *     private String password;
 * }
 * </pre>
 *
 * @see PasswordValidator 实际执行验证的验证器类
 */
@Documented
@Constraint(validatedBy = PasswordValidator.class)
@Target({ ElementType.FIELD, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidPassword {
    String message() default "无效的密码：密码必须至少8个字符长，包含至少一个大写字母，一个小写字母，一个数字和一个特殊字符。";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}