docs 补充项目注释

2026-06-01 10:48:09 +08:00
parent f3ed8e82a7
commit 941c0b9032
73 changed files with 531 additions and 1 deletions
@@ -33,8 +33,14 @@ public @interface DictPattern {
     */
    String message() default "字典值无效";

+    /**
+     * Bean Validation 分组。
+     */
    Class<?>[] groups() default {};

+    /**
+     * Bean Validation 负载信息。
+     */
    Class<? extends Payload>[] payload() default {};

 }
@@ -32,16 +32,32 @@ public @interface EnumPattern {
     */
    String fieldName();

+    /**
+     * 校验失败时返回的错误消息。
+     */
    String message() default "输入值不在枚举范围内";

+    /**
+     * Bean Validation 分组。
+     */
    Class<?>[] groups() default {};

+    /**
+     * Bean Validation 负载信息。
+     */
    Class<? extends Payload>[] payload() default {};

+    /**
+     * 支持在同一元素上重复声明多个枚举校验规则。
+     */
    @Documented
    @Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
    @Retention(RUNTIME)
    @interface List {
+
+        /**
+         * 重复声明的枚举校验规则集合。
+         */
        EnumPattern[] value();
    }

@@ -17,10 +17,19 @@ import java.lang.annotation.Target;
@Constraint(validatedBy = {XssValidator.class})
 public @interface Xss {

+    /**
+     * 校验失败时返回的错误消息。
+     */
    String message() default "不允许任何脚本运行";

+    /**
+     * Bean Validation 分组。
+     */
    Class<?>[] groups() default {};

+    /**
+     * Bean Validation 负载信息。
+     */
    Class<? extends Payload>[] payload() default {};

 }