refactor(Validator): 重构 validator 包下的注解

lin-cms-spring-boot-autoconfigure/src/main/java/io/github/talelin/autoconfigure/validator/DateTimeFormat.java

@@ -1,25 +1,37 @@
 package io.github.talelin.autoconfigure.validator;
 
+import io.github.talelin.autoconfigure.validator.impl.DateTimeFormatValidator;
+
+import javax.validation.Constraint;
 import javax.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;
+
+import static java.lang.annotation.ElementType.FIELD;
+import static java.lang.annotation.ElementType.TYPE_PARAMETER;
+import static java.lang.annotation.ElementType.TYPE_USE;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
- * 日期格式校验器 默认校验日期格式 yyyy-MM-dd HH:mm:ss
- * 可通过指定 format 来更改校验格式
+ * 日期格式校验器
+ * 对 String 类型进行校验，是否匹配给定的模式
+ * 默认校验日期格式 yyyy-MM-dd HH:mm:ss
  *
  * @author pedro@TaleLin
+ * @author Juzi@TaleLin
  */
+@Documented
+@Retention(RUNTIME)
+@Target({FIELD, TYPE_USE, TYPE_PARAMETER})
+@Constraint(validatedBy = DateTimeFormatValidator.class)
 public @interface DateTimeFormat {
 
-    String message() default "date format invalid";
-
-    String format() default "yyyy-MM-dd HH:mm:ss";
+    String message() default "date pattern invalid";
 
-    /**
-     * 是否允许传入空的日期，如果为false，当传入空字符串时，校验失败
-     *
-     * @return 是否可以为空
-     */
-    boolean allowNull() default false;
+    String pattern() default "yyyy-MM-dd HH:mm:ss";
 
     Class<?>[] groups() default {};
 

lin-cms-spring-boot-autoconfigure/src/main/java/io/github/talelin/autoconfigure/validator/EnumValue.java

@@ -0,0 +1,39 @@
+package io.github.talelin.autoconfigure.validator;
+
+import io.github.talelin.autoconfigure.validator.impl.EnumValueValidator;
+
+import javax.validation.Constraint;
+import javax.validation.Payload;
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.FIELD;
+import static java.lang.annotation.ElementType.TYPE_PARAMETER;
+import static java.lang.annotation.ElementType.TYPE_USE;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * 枚举校验
+ * 校验的值必须为 target (枚举类)中的一项
+ *
+ * @author pedro@TaleLin
+ * @author jUZI@TaleLin
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({FIELD, TYPE_USE, TYPE_PARAMETER})
+@Constraint(validatedBy = EnumValueValidator.class)
+public @interface EnumValue {
+
+    /**
+     * 目标值，必须是一个枚举类
+     */
+    Class<? extends Enum<?>> target();
+
+    String message() default "value must in enum";
+
+    Class<?>[] groups() default {};
+
+    Class<? extends Payload>[] payload() default {};
+}

lin-cms-spring-boot-autoconfigure/src/main/java/io/github/talelin/autoconfigure/validator/EqualField.java

@@ -8,23 +8,30 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import static java.lang.annotation.ElementType.*;
+import static java.lang.annotation.ElementType.TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
- * 字段相等
+ * 比较两个属性是否相等
  *
  * @author pedro@TaleLin
+ * @author Juzi@TaleLin
  */
-@Target({TYPE, METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER})
-@Retention(RUNTIME)
 @Documented
-@Constraint(validatedBy = {EqualFieldValidator.class})
+@Target(TYPE)
+@Retention(RUNTIME)
+@Constraint(validatedBy = EqualFieldValidator.class)
 public @interface EqualField {
 
-    String srcField() default "";
+    /**
+     * 源属性
+     */
+    String srcField();
 
-    String dstField() default "";
+    /**
+     * 目标属性
+     */
+    String dstField();
 
     String message() default "the two fields must be equal";
 

lin-cms-spring-boot-autoconfigure/src/main/java/io/github/talelin/autoconfigure/validator/impl/DateTimeFormatValidator.java

@@ -0,0 +1,58 @@
+package io.github.talelin.autoconfigure.validator.impl;
+
+import io.github.talelin.autoconfigure.validator.DateTimeFormat;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import javax.validation.ConstraintValidator;
+import javax.validation.ConstraintValidatorContext;
+import java.text.SimpleDateFormat;
+
+/**
+ * 日期校验器实现
+ *
+ * @author pedro@TaleLin
+ * @author Juzi@TaleLin
+ */
+public class DateTimeFormatValidator implements ConstraintValidator<DateTimeFormat, String> {
+
+    private static final Logger log = LoggerFactory.getLogger(DateTimeFormatValidator.class);
+
+    private DateTimeFormat dateTimeFormat;
+
+    @Override
+    public void initialize(DateTimeFormat dateTime) {
+        this.dateTimeFormat = dateTime;
+    }
+
+    /**
+     * 校验
+     *
+     * @param value   传入数据
+     * @param context 上下文
+     * @return 是否成功
+     */
+    @Override
+    public boolean isValid(String value, ConstraintValidatorContext context) {
+        // value 为 null，校验通过
+        if (value == null) {
+            return true;
+        }
+
+        String format = dateTimeFormat.pattern();
+
+        // 长度不同，则肯定格式不匹配，校验不通过
+        if (value.length() != format.length()) {
+            return false;
+        }
+
+        SimpleDateFormat simpleDateFormat = new SimpleDateFormat(format);
+        try {
+            simpleDateFormat.parse(value);
+            return true;
+        } catch (Exception e) {
+            log.warn("DateTimeFormat 校验异常", e);
+            return false;
+        }
+    }
+}