[fit] 完善注释

Author: Yager-42

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-jakarta/src/main/java/modelengine/fitframework/validation/ValidationHandler.java

@@ -150,7 +150,7 @@ private boolean hasConstraintAnnotationsInType(AnnotatedType annotatedType) {
      *     </li>
      * </ol>
      *
-     * @param annotation 要检查的注解 {@link java.lang.annotation.Annotation}
+     * @param annotation 要检查的注解 {@link java.lang.annotation.Annotation}。
      * @return 如果属于 {@code jakarta.validation} 注解（即 @Valid 或携带 @Constraint），则返回 {@code true}，否则返回 {@code false}。
      */
     private boolean isJakartaConstraintAnnotation(Annotation annotation) {

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-jakarta/src/test/java/modelengine/fitframework/validation/data/Employee.java

@@ -32,7 +32,7 @@ public Employee() {}
      * 构造函数。
      *
      * @param name 姓名 {@link String}。
-     * @param age 年龄 {@code int}
+     * @param age 年龄 {@code int}。
      */
     public Employee(String name, int age) {
         this.name = name;

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-jakarta/src/test/java/modelengine/fitframework/validation/data/GroupValidateService.java

@@ -29,7 +29,7 @@ public static class StudentValidateService {
         /**
          * 验证学生年龄。
          *
-         * @param age 年龄 {@code int}
+         * @param age 年龄 {@code int}。
          */
         public void validateStudentAge(
                 @Min(value = 7, message = "范围要在7~20之内", groups = ValidationTestData.StudentGroup.class) @Max(
@@ -45,7 +45,7 @@ public static class TeacherValidateService {
         /**
          * 验证教师年龄。
          *
-         * @param age 年龄 {@code int}
+         * @param age 年龄 {@code int}。
          */
         public void validateTeacherAge(
                 @Min(value = 22, message = "范围要在22~65之内", groups = ValidationTestData.TeacherGroup.class) @Max(
@@ -62,7 +62,7 @@ public static class AdvancedValidateService {
         /**
          * 验证高级分组数据。
          *
-         * @param data 用于测试复杂对象验证的数据 {@link ValidationTestData}
+         * @param data 用于测试复杂对象验证的数据 {@link ValidationTestData}。
          */
         public void validateAdvancedGroup(@Valid ValidationTestData data) {
             LOG.debug("Validating advanced group data: {}", data);

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-jakarta/src/test/java/modelengine/fitframework/validation/data/ValidateService.java

@@ -400,7 +400,8 @@ public void validateEmployeeMapList(List<Map<String, @Valid Employee>> listOfMap
     /**
      * 验证员工数据列表映射。
      *
-     * @param map 表示输入的 {@link Map}{@code <}{@link Employee}{@code , }{@link List}{@code <}{@link ValidationTestData}{@code >}{}。
+     * @param map 表示输入的
+     * {@link Map}{@code <}{@link Employee}{@code , }{@link List}{@code <}{@link ValidationTestData}{@code >}。
      */
     public void validateEmployeeDataListMap(Map<@Valid Employee, List<@Valid ValidationTestData>> map) {
         LOG.debug("Validating employee data list map: {}", map);

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-jakarta/src/test/java/modelengine/fitframework/validation/data/ValidationTestData.java

@@ -22,7 +22,7 @@
  * @since 2025-07-18
  */
 public class ValidationTestData {
-    // 分组接口定义
+    // 分组接口定义。
     public interface AdvancedGroup {}
 
     public interface StudentGroup {}

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-javax/src/main/java/modelengine/fitframework/validation/ValidationHandler.java

@@ -150,7 +150,7 @@ private boolean hasConstraintAnnotationsInType(AnnotatedType annotatedType) {
      *     </li>
      * </ol>
      *
-     * @param annotation 要检查的注解 {@link java.lang.annotation.Annotation}
+     * @param annotation 要检查的注解 {@link java.lang.annotation.Annotation}。
      * @return 如果属于 {@code javax.validation} 注解（即 @Valid 或携带 @Constraint），则返回 {@code true}，否则返回 {@code false}。
      */
     private boolean isJavaxConstraintAnnotation(Annotation annotation) {

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-javax/src/test/java/modelengine/fitframework/validation/data/Employee.java

@@ -32,7 +32,7 @@ public Employee() {}
      * 构造函数。
      *
      * @param name 姓名 {@link String}。
-     * @param age 年龄 {@code int}
+     * @param age 年龄 {@code int}。
      */
     public Employee(String name, int age) {
         this.name = name;

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-javax/src/test/java/modelengine/fitframework/validation/data/GroupValidateService.java

@@ -30,7 +30,7 @@ public static class StudentValidateService {
         /**
          * 验证学生年龄。
          *
-         * @param age 年龄 {@code int}
+         * @param age 年龄 {@code int}。
          */
         public void validateStudentAge(
                 @Min(value = 7, message = "范围要在7~20之内", groups = ValidationTestData.StudentGroup.class) @Max(
@@ -46,7 +46,7 @@ public static class TeacherValidateService {
         /**
          * 验证教师年龄。
          *
-         * @param age 年龄 {@code int}
+         * @param age 年龄 {@code int}。
          */
         public void validateTeacherAge(
                 @Min(value = 22, message = "范围要在22~65之内", groups = ValidationTestData.TeacherGroup.class) @Max(
@@ -63,7 +63,7 @@ public static class AdvancedValidateService {
         /**
          * 验证高级分组数据。
          *
-         * @param data 用于测试复杂对象验证的数据 {@link ValidationTestData}
+         * @param data 用于测试复杂对象验证的数据 {@link ValidationTestData}。
          */
         public void validateAdvancedGroup(@Valid ValidationTestData data) {
             LOG.debug("Validating advanced group data: {}", data);

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-javax/src/test/java/modelengine/fitframework/validation/data/ValidateService.java

@@ -401,7 +401,8 @@ public void validateEmployeeMapList(List<Map<String, @Valid Employee>> listOfMap
     /**
      * 验证员工数据列表映射。
      *
-     * @param map 表示输入的 {@link Map}{@code <}{@link Employee}{@code , }{@link List}{@code <}{@link ValidationTestData}{@code >}{}。
+     * @param map 表示输入的
+     * {@link Map}{@code <}{@link Employee}{@code , }{@link List}{@code <}{@link ValidationTestData}{@code >}。
      */
     public void validateEmployeeDataListMap(Map<@Valid Employee, List<@Valid ValidationTestData>> map) {
         LOG.debug("Validating employee data list map: {}", map);

framework/fit/java/fit-builtin/plugins/fit-validation-hibernate-javax/src/test/java/modelengine/fitframework/validation/data/ValidationTestData.java

@@ -22,7 +22,7 @@
  * @since 2025-07-18
  */
 public class ValidationTestData {
-    // 分组接口定义
+    // 分组接口定义。
     public interface AdvancedGroup {}
 
     public interface StudentGroup {}