fix: 🐛 Support for @JsonSerialize using ToStringSerializer

- Update IRestDocTemplate.java with new process methods for API data and documentation generation.- Enhance JavaClassUtil.java and JsonBuildHelper.java to handle @JsonSerialize annotation with ToStringSerializer.
- Refactor ParamsBuildHelper.java to support new serialization features.
- Remove deprecated code and streamline documentation generation flow.

See [issues #833](#833)
See [issues #714](#714)

Author: linwumingshi

src/main/java/com/ly/doc/helper/JsonBuildHelper.java

@@ -271,9 +271,18 @@ else if (JavaClassValidateUtil.isReactor(typeName)) {
                 List<JavaAnnotation> annotations = docField.getAnnotations();
 
                 String jsonFormatString = null;
+                // has Annotation @JsonSerialize And using ToStringSerializer
+                boolean toStringSerializer = false;
                 // Handle annotations on the field
                 for (JavaAnnotation annotation : annotations) {
                     String annotationName = annotation.getType().getValue();
+                    // if the field is annotated with @JsonSerialize
+                    if (DocAnnotationConstants.SHORT_JSON_SERIALIZE.equals(annotationName) &&
+                            DocAnnotationConstants.TO_STRING_SERIALIZER_USING.equals(annotation.getNamedParameter("using"))) {
+                        toStringSerializer = true;
+                        continue;
+                    }
+
                     if (JSRAnnotationConstants.NULL.equals(annotationName) && !isResp) {
                         if (CollectionUtil.isEmpty(groupClasses)) {
                             continue out;
@@ -340,9 +349,13 @@ else if (DocAnnotationConstants.JSON_FORMAT.equals(annotationName)) {
                 if (JavaClassValidateUtil.isPrimitive(subTypeName)) {
                     int data0Length = data0.length();
                     if (StringUtil.isEmpty(fieldValue)) {
-                        fieldValue = StringUtil.isNotEmpty(jsonFormatString)
-                                ? jsonFormatString
-                                : DocUtil.getValByTypeAndFieldName(typeSimpleName, field.getName());
+                        String valueByTypeAndFieldName = DocUtil.getValByTypeAndFieldName(typeSimpleName, field.getName());
+                        if (toStringSerializer && isResp) {
+                            fieldValue = valueByTypeAndFieldName.startsWith("\"") && valueByTypeAndFieldName.endsWith("\"")
+                                    ? valueByTypeAndFieldName : DocUtil.handleJsonStr(valueByTypeAndFieldName);
+                        } else {
+                            fieldValue = StringUtil.isNotEmpty(jsonFormatString) ? jsonFormatString : valueByTypeAndFieldName;
+                        }
                     }
                     if (Objects.nonNull(customRequestField) && !isResp && typeName.equals(customRequestField.getOwnerClassName())) {
                         JavaFieldUtil.buildCustomField(data0, typeSimpleName, customRequestField);
@@ -479,6 +492,11 @@ else if (JavaTypeConstants.JAVA_OBJECT_FULLY.equals(fieldGicName)) {
                             if (tagsMap.containsKey(DocTags.MOCK) && StringUtil.isNotEmpty(tagsMap.get(DocTags.MOCK))) {
                                 data0.append(tagsMap.get(DocTags.MOCK)).append(",");
                             }
+                            // if has Annotation @JsonSerialize And using ToStringSerializer  && isResp
+                            else if (toStringSerializer && isResp) {
+                                Object value = JavaClassUtil.getEnumValue(javaClass, Boolean.FALSE);
+                                data0.append(value).append(",");
+                            }
                             // if has @JsonFormat
                             else if (StringUtil.isNotEmpty(jsonFormatString)) {
                                 data0.append(jsonFormatString).append(",");
@@ -487,7 +505,10 @@ else if (StringUtil.isNotEmpty(jsonFormatString)) {
                                 data0.append(value).append(",");
                             }
                         } else {
-                            if (StringUtil.isNotEmpty(jsonFormatString)) {
+                            // if has Annotation @JsonSerialize And using ToStringSerializer  && isResp
+                            if (toStringSerializer && isResp) {
+                                data0.append(" ").append(",");
+                            } else if (StringUtil.isNotEmpty(jsonFormatString)) {
                                 data0.append(jsonFormatString).append(",");
                             } else {
                                 fieldGicName = DocUtil.formatFieldTypeGicName(genericMap, fieldGicName);

src/main/java/com/ly/doc/helper/ParamsBuildHelper.java

@@ -192,7 +192,14 @@ public static List<ApiParam> buildParams(String className, String pre, int level
                     continue;
                 }
                 String fieldJsonFormatType = null;
+                // has Annotation @JsonSerialize And using ToStringSerializer
+                boolean toStringSerializer = false;
                 for (JavaAnnotation annotation : javaAnnotations) {
+                    if (DocAnnotationConstants.SHORT_JSON_SERIALIZE.equals(annotation.getType().getSimpleName()) &&
+                            DocAnnotationConstants.TO_STRING_SERIALIZER_USING.equals(annotation.getNamedParameter("using"))) {
+                        toStringSerializer = true;
+                        continue;
+                    }
                     if (JavaClassValidateUtil.isIgnoreFieldJson(annotation, isResp)) {
                         continue out;
                     }
@@ -298,7 +305,7 @@ public static List<ApiParam> buildParams(String className, String pre, int level
                     ApiParam param = ApiParam.of().setClassName(className).setField(pre + fieldName);
                     param.setPid(pid).setMaxLength(maxLength).setValue(fieldValue);
                     param.setId(atomicOrDefault(atomicInteger, paramList.size() + param.getPid() + 1));
-                    String processedType = StringUtil.isNotEmpty(fieldJsonFormatType)
+                    String processedType = (isResp && toStringSerializer) ? "string" : StringUtil.isNotEmpty(fieldJsonFormatType)
                             ? fieldJsonFormatType
                             : processFieldTypeName(isShowJavaType, subTypeName);
                     param.setType(processedType);