|
|
package com.utils;
|
|
|
|
|
|
import java.util.Set;
|
|
|
|
|
|
import javax.validation.ConstraintViolation;
|
|
|
import javax.validation.Validation;
|
|
|
import javax.validation.Validator;
|
|
|
|
|
|
import com.entity.EIException;
|
|
|
|
|
|
/**
|
|
|
* hibernate-validator校验工具类
|
|
|
* 该类借助Hibernate Validator框架，为对象提供校验功能。
|
|
|
* 当对象不符合预先定义的约束条件时，会抛出EIException异常。
|
|
|
*/
|
|
|
public class ValidatorUtils {
|
|
|
// 静态的Validator对象，用于执行校验操作。
|
|
|
// 由于Validator是线程安全的，使用静态变量可以在整个应用程序中共享同一个实例，提高性能。
|
|
|
private static Validator validator;
|
|
|
|
|
|
// 静态代码块，在类加载时执行，确保Validator对象只被初始化一次。
|
|
|
// 通过Validation类构建默认的验证工厂，然后从工厂中获取Validator实例。
|
|
|
static {
|
|
|
validator = Validation.buildDefaultValidatorFactory().getValidator();
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 校验对象的方法
|
|
|
*
|
|
|
* @param object 待校验的对象，该对象需要使用Hibernate Validator的注解来定义约束条件。
|
|
|
* @param groups 待校验的组，可用于指定在不同场景下应用不同的约束条件。
|
|
|
* @throws EIException 若校验不通过，即对象存在违反约束的情况，会抛出EIException异常。
|
|
|
* 异常信息为第一个违反约束的详细描述。
|
|
|
*/
|
|
|
public static void validateEntity(Object object, Class<?>... groups)
|
|
|
throws EIException {
|
|
|
// 调用Validator的validate方法对对象进行校验，根据指定的组应用相应的约束条件。
|
|
|
// 该方法会返回一个包含所有违反约束信息的Set集合。
|
|
|
Set<ConstraintViolation<Object>> constraintViolations = validator.validate(object, groups);
|
|
|
|
|
|
// 检查约束违反集合是否为空，若不为空则表示存在校验不通过的情况。
|
|
|
if (!constraintViolations.isEmpty()) {
|
|
|
// 获取集合中的第一个违反约束的信息。
|
|
|
// 这里仅取第一个违反约束的信息作为异常信息抛出，可能会忽略其他违反约束的情况。
|
|
|
ConstraintViolation<Object> constraint = (ConstraintViolation<Object>)constraintViolations.iterator().next();
|
|
|
// 抛出EIException异常，将违反约束的详细信息作为异常消息。
|
|
|
throw new EIException(constraint.getMessage());
|
|
|
}
|
|
|
}
|
|
|
}
|
