Merge branch '3.5.x'

Author: CodeCasterX

framework/fel/java/fel-core/src/main/java/modelengine/fel/core/format/json/ObjectJsonOutputParser.java

@@ -21,6 +21,7 @@ public class ObjectJsonOutputParser extends AbstractJsonOutputParser<Object> {
      * 创建 {@link ObjectJsonOutputParser} 的实例。
      *
      * @param serializer 表示对象序列化器的 {@link ObjectSerializer}。
+     * @param jsonSchema 表示 Json 格式的描述文件的 {@link String}。
      */
     public ObjectJsonOutputParser(ObjectSerializer serializer, String jsonSchema) {
         super(serializer, Object.class);

framework/fel/java/fel-core/src/main/java/modelengine/fel/core/pattern/PostProcessor.java

@@ -19,7 +19,7 @@ public interface PostProcessor<D> extends Pattern<D, D> {
      * 对检索结果进行后处理。
      *
      * @param data 表示输入数据的 {@link D}。
-     * @return 表示处理后数据的 {@link D>}。
+     * @return 表示处理后数据的 {@link D}。
      */
     D process(D data);
 

framework/fel/java/fel-core/src/main/java/modelengine/fel/core/pattern/Store.java

@@ -18,7 +18,7 @@ public interface Store<D> extends Pattern<D, Void> {
     /**
      * 添加数据到存储中。
      *
-     * @param data 表示待添加数据的 {@link D>}。
+     * @param data 表示待添加数据的 {@link D}。
      */
     void persistent(D data);
 

framework/fel/java/fel-core/src/main/java/modelengine/fel/core/retriever/filter/AbstractExpressionParser.java

@@ -44,12 +44,10 @@ protected void parseOperand(Operand operand, StringBuilder buf) {
 
     /**
      * 解析值对象，有以下两种情况：
-     * <p>
      * <ol>
      *     <li>如果是集合，则将集合中的每一个元素分别解析后组装</li>
      *     <li>如果不是集合，则直接进行解析</li>
      * </ol>
-     * </p>
      *
      * @param value 表示值对象的 {@link Operand.Value}。
      * @param buf 表示输出缓冲区的 {@link StringBuilder}。

framework/fel/java/fel-core/src/main/java/modelengine/fel/core/retriever/filter/Operator.java

@@ -13,15 +13,36 @@
  * @since 2024-08-10
  */
 public enum Operator {
+    /** 等于。 */
     EQ,
+
+    /** 不等于。 */
     NE,
+
+    /** 小于。 */
     LT,
+
+    /** 大于。 */
     GT,
+
+    /** 小于等于。 */
     LE,
+
+    /** 大于等于。 */
     GE,
+
+    /** 在集合中。 */
     IN,
+
+    /** 不在集合中。 */
     NIN,
+
+    /** 模糊匹配。 */
     LIKE,
+
+    /** 或运算。 */
     OR,
-    AND,
+
+    /** 与运算。 */
+    AND
 }

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

@@ -9,9 +9,9 @@
 import static modelengine.fit.serialization.json.jackson.JacksonObjectSerializer.DEFAULT_DATE_FORMAT;
 import static modelengine.fit.serialization.json.jackson.JacksonObjectSerializer.DEFAULT_DATE_TIME_FORMAT;
 
+import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.databind.ObjectMapper;
 
-import modelengine.fel.maven.complie.util.JsonUtils;
 import modelengine.fel.tool.ToolSchema;
 import modelengine.fel.tool.info.entity.ToolJsonEntity;
 import modelengine.fit.serialization.json.jackson.JacksonObjectSerializer;
@@ -28,7 +28,6 @@
 import java.nio.file.Paths;
 import java.util.LinkedList;
 import java.util.List;
-import java.util.Map;
 import java.util.stream.Stream;
 
 /**
@@ -80,7 +79,9 @@ public void outputToolManifest(String outputDirectory, ToolJsonEntity toolJsonEn
                 DEFAULT_DATE_FORMAT,
                 "Asia/Shanghai"
         );
-        serializer.getMapper().writerWithDefaultPrettyPrinter().writeValue(jsonFile, toolJsonEntity);
+        ObjectMapper objectMapper = serializer.getMapper().copy();
+        objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
+        objectMapper.writerWithDefaultPrettyPrinter().writeValue(jsonFile, toolJsonEntity);
         log.info("Write tool json successfully. [file={}]", jsonFile.getName());
     }
 }

framework/fit/java/fit-builtin/plugins/fit-message-serializer-json-jackson/src/main/java/modelengine/fit/serialization/json/jackson/JacksonObjectSerializer.java

@@ -9,7 +9,6 @@
 import static modelengine.fitframework.inspection.Validation.notNull;
 
 import com.fasterxml.jackson.annotation.JsonAutoDetect;
-import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.core.JsonEncoding;
 import com.fasterxml.jackson.core.JsonFactoryBuilder;
 import com.fasterxml.jackson.core.JsonGenerator;
@@ -84,8 +83,7 @@ public JacksonObjectSerializer(@Value("${date-time-format}") String dateTimeForm
                 .maxStringLength(Integer.MAX_VALUE)
                 .build()).build()).configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
                 .setAnnotationIntrospector(new FitAnnotationIntrospector())
-                .setVisibility(visibilityChecker)
-                .setSerializationInclusion(JsonInclude.Include.NON_NULL);
+                .setVisibility(visibilityChecker);
         SimpleModule module = new SimpleModule();
         module.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(dateTimeFormat));
         module.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(dateTimeFormat));

framework/fit/java/fit-builtin/plugins/fit-message-serializer-json-jackson/src/test/java/modelengine/fit/serialization/json/jackson/JacksonObjectSerializerTest.java

@@ -212,7 +212,7 @@ void givenAliasJsonThenDeserializeOk() {
     @Test
     @DisplayName("当存在别名时，序列化成功")
     void givenAliasObjectThenSerializeOk() {
-        String expect = "{\"first_name\":\"foo\"}";
+        String expect = "{\"lastName\":null,\"first_name\":\"foo\",\"person_name\":null}";
         PersonAlias personAlias = new PersonAlias();
         personAlias.firstName("foo");
         assertThat(this.jsonSerializer.serialize(personAlias)).isEqualTo(expect);
@@ -229,7 +229,7 @@ void givenJsonPropertyThenDeserializeOriginOk() {
     @Test
     @DisplayName("当使用原生注解，存在别名时，序列化成功")
     void givenJsonPropertyThenSerializeOriginOk() {
-        String expect = "{\"lastName\":\"bar\"}";
+        String expect = "{\"lastName\":\"bar\",\"first_name\":null,\"person_name\":null}";
         PersonAlias personAlias = new PersonAlias();
         personAlias.lastName("bar");
         assertThat(this.jsonSerializer.serialize(personAlias)).isEqualTo(expect);