[maven-tool] 修改检视意见

Author: surpercodehang

framework/fel/java/maven-plugins/tool-maven-plugin/src/main/java/modelengine/fel/maven/complie/parser/ByteBuddySchemaParser.java

@@ -14,6 +14,8 @@
 import modelengine.fel.tool.info.entity.ReturnPropertyEntity;
 import modelengine.fel.tool.info.entity.SchemaEntity;
 import modelengine.fitframework.annotation.Property;
+import modelengine.fitframework.annotation.util.PropertyHelper;
+import modelengine.fitframework.util.StringUtils;
 
 import net.bytebuddy.description.annotation.AnnotationDescription;
 import net.bytebuddy.description.method.MethodDescription;
@@ -115,11 +117,11 @@ private static PropertyEntity parseProperty(ParameterDescription parameterDescri
             entity.setDescription(property.description());
             entity.setNeed(property.required());
             String defaultValue = property.defaultValue();
-            if (defaultValue != null && !defaultValue.isEmpty()) {
+            if (defaultValue != null && PropertyHelper.isCustomValue(property.defaultValue())) {
                 entity.setDefaultValue(defaultValue);
             }
             String example = property.example();
-            if (example != null && !example.isEmpty()) {
+            if (StringUtils.isNotEmpty(example)) {
                 entity.setExamples(Collections.singletonList(example));
             }
         }
@@ -135,7 +137,7 @@ private static ReturnPropertyEntity parseReturnProperty(MethodDescription method
             returnPropertyEntity.setName(property.name());
             returnPropertyEntity.setDescription(property.description());
             String example = property.example();
-            if (example != null && !example.isEmpty()) {
+            if (StringUtils.isNotEmpty(example)) {
                 returnPropertyEntity.setExamples(Collections.singletonList(example));
             }
         }

framework/fel/java/services/tool-service/src/main/java/modelengine/fel/tool/support/MethodToolMetadata.java

@@ -13,6 +13,7 @@
 import modelengine.fel.tool.annotation.Group;
 import modelengine.fel.tool.annotation.ToolMethod;
 import modelengine.fitframework.annotation.Property;
+import modelengine.fitframework.annotation.util.PropertyHelper;
 import modelengine.fitframework.json.schema.JsonSchemaManager;
 import modelengine.fitframework.util.MapBuilder;
 import modelengine.fitframework.util.StringUtils;
@@ -68,7 +69,7 @@ public Object parameterDefaultValue(String name) {
             Property annotation = parameter.getDeclaredAnnotation(Property.class);
             if (annotation != null) {
                 String defaultValue = annotation.defaultValue();
-                if (defaultValue != null && !defaultValue.isEmpty()) {
+                if (defaultValue != null && PropertyHelper.isCustomValue(annotation.defaultValue())) {
                     return defaultValue;
                 }
             }

framework/fit/java/fit-util/src/main/java/modelengine/fitframework/annotation/Property.java

@@ -24,6 +24,11 @@
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD})
 public @interface Property {
+    /**
+     * 表示未设置默认值的标记常量。
+     */
+    String UNSET_DEFAULT_VALUE = "$$Fit$UnsetDefaultValue$$";
+
     /**
      * 获取参数的名字。
      *
@@ -50,7 +55,7 @@
      *
      * @return 表示参数的默认值的 {@link String}。
      */
-    String defaultValue() default StringUtils.EMPTY;
+    String defaultValue() default UNSET_DEFAULT_VALUE;
 
     /**
      * 获取参数的样例值。

framework/fit/java/fit-util/src/main/java/modelengine/fitframework/annotation/util/PropertyHelper.java

@@ -0,0 +1,33 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) 2025 Huawei Technologies Co., Ltd. All rights reserved.
+ *  This file is a part of the ModelEngine Project.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+package modelengine.fitframework.annotation.util;
+
+import modelengine.fitframework.annotation.Property;
+
+/**
+ * 为 Property 注解提供工具类。
+ *
+ * @author 杭潇
+ * @since 2025-10-29
+ */
+public final class PropertyHelper {
+    /**
+     * 隐藏默认构造方法，避免工具类被实例化。
+     */
+    private PropertyHelper() {}
+
+    /**
+     * 判断给定的默认值是否为设置状态。
+     *
+     * @param defaultValue 要检查的默认值。
+     * @return 如果自定义参数值则返回 {@code true}，否则返回 {@code false}。
+     */
+    public static boolean isCustomValue(String defaultValue) {
+        return !Property.UNSET_DEFAULT_VALUE.equals(defaultValue);
+    }
+}
+