data, String rootTagName) {
+ if (data == null) return null;
+ StringBuilder xml = new StringBuilder();
+ xml.append("\n");
+ appendTag(xml, rootTagName, data, "");
+ return xml.toString();
+ }
+
+ private void appendTag(StringBuilder sb, String tagName, Object value, String indent) {
+ // Extract pure tag name for closing tag (handle attributes in tagName like "Root attr='val'")
+ String pureTagName = tagName.split("\\s+")[0];
+
+ if (value == null) {
+ sb.append(indent).append("<").append(tagName).append("/>\n");
+ return;
+ }
+
+ if (value instanceof Map) {
+ sb.append(indent).append("<").append(tagName).append(">\n");
+ Map map = (Map) value;
+ for (Map.Entry entry : map.entrySet()) {
+ if (entry.getKey() != null) {
+ appendTag(sb, entry.getKey().toString(), entry.getValue(), indent + " ");
+ }
+ }
+ sb.append(indent).append("\n");
+ } else if (value instanceof List) {
+ List list = (List) value;
+ for (Object item : list) {
+ appendTag(sb, tagName, item, indent);
+ }
+ } else {
+ sb.append(indent).append("<").append(tagName).append(">");
+ String valStr = value.toString();
+ valStr = escapeXml(valStr);
+ sb.append(valStr);
+ sb.append("\n");
+ }
+ }
+
+ private String escapeXml(String str) {
+ if (str == null) return "";
+ return str.replace("&", "&")
+ .replace("<", "<")
+ .replace(">", ">")
+ .replace("\"", """)
+ .replace("'", "'");
+ }
+}
diff --git a/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlEntityToXmlGeneratorService.java b/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlEntityToXmlGeneratorService.java
new file mode 100644
index 000000000..23dea4495
--- /dev/null
+++ b/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlEntityToXmlGeneratorService.java
@@ -0,0 +1,229 @@
+package com.yourcompany.xml.generator.utils.api;
+
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.MapperFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.netease.lowcode.core.annotation.NaslLogic;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Service;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 实体(JSON)转XML生成服务
+ *
+ * 将入参的实体JSON按指定类型反序列化后，基于实体字段值生成XML字符串。
+ * 生成规则与 {@link XmlGeneratorUtilsService#mapToXml(Map, List, String)} 保持一致：
+ * 支持XML声明、缩进、List重复标签、Map嵌套标签、以及在标签名包含属性时的闭合标签处理。
+ *
+ * 说明：由于平台侧入参/返回值不允许使用Object类型，且实体无法添加XML注解，本服务采用：
+ * JSON字符串 + Class<T> 的方式还原实体，并开启字段名大小写不敏感以增强兼容性。
+ */
+@Service
+public class XmlEntityToXmlGeneratorService {
+
+ private static final Logger LCAP_LOGGER = LoggerFactory.getLogger("LCAP_EXTENSION_LOGGER");
+
+ private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
+
+ static {
+ OBJECT_MAPPER.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
+ OBJECT_MAPPER.configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, true);
+ }
+
+ /**
+ * 将实体JSON转换为XML字符串
+ *
+ * 入参作用：
+ *
+ * - entityJson：实体数据（JSON字符串）。用于在不暴露Object类型入参的前提下传递复杂结构。
+ * - clazz：实体类型。用于将JSON反序列化为目标实体，并支持字段名大小写不敏感匹配。
+ * - keyOrder：子节点顺序列表（可为空）。不为空时仅输出列表命中的字段，并按该顺序生成(只控制 根节点下一级 子标签顺序)。
+ * - keyOrderByTag：嵌套节点的子节点顺序配置（可为空）。Key为父节点标签名，Value为其子节点顺序。
+ * - rootTagName：根节点名称（必填）。可包含属性，例如 {@code Certificate xmlns="..."}。
+ *
+ *
+ * 大小写处理：
+ *
+ * - 反序列化实体时：字段名大小写不敏感。
+ * - 生成XML且指定keyOrder时：会对实体字段名做大小写不敏感匹配，但输出标签名以keyOrder中的key为准。
+ * - 生成XML且指定keyOrderByTag时：会对各层节点的字段名做大小写不敏感匹配，但输出标签名以配置中的key为准。
+ *
+ *
+ * @param entityJson 实体JSON字符串
+ * @param clazz 目标实体类型
+ * @param keyOrder XML子节点顺序列表（可为空）
+ * @param keyOrderByTag 嵌套节点的子节点顺序配置（可为空）
+ * @param rootTagName XML根节点名称（必填）
+ * @param 目标实体泛型类型
+ * @return 生成的XML字符串；当必填入参为空时返回null
+ */
+ @NaslLogic
+ public String entityJsonToXml(String entityJson, Class clazz, List keyOrder, Map> keyOrderByTag, String rootTagName) {
+ if (entityJson == null || entityJson.trim().isEmpty()) {
+ LCAP_LOGGER.error("输入实体 JSON 为空");
+ return null;
+ }
+ if (clazz == null) {
+ LCAP_LOGGER.error("实体类型 clazz 为空");
+ return null;
+ }
+ if (rootTagName == null || rootTagName.trim().isEmpty()) {
+ LCAP_LOGGER.error("根节点名称不能为空");
+ return null;
+ }
+
+ try {
+ T entity = OBJECT_MAPPER.readValue(entityJson, clazz);
+ Map dataMap = OBJECT_MAPPER.convertValue(entity, new TypeReference>() {});
+
+ StringBuilder xml = new StringBuilder();
+ xml.append("\n");
+
+ if (keyOrder != null && !keyOrder.isEmpty()) {
+ String pureRootTagName = rootTagName.trim().split("\\s+")[0];
+ xml.append("<").append(rootTagName).append(">\n");
+
+ Map lowerKeyToOriginalKey = new HashMap<>();
+ for (String key : dataMap.keySet()) {
+ if (key == null) {
+ continue;
+ }
+ lowerKeyToOriginalKey.putIfAbsent(key.toLowerCase(), key);
+ }
+
+ for (String key : keyOrder) {
+ if (key == null) {
+ continue;
+ }
+ String trimmedKey = key.trim();
+ if (trimmedKey.isEmpty()) {
+ continue;
+ }
+
+ String matchedKey = dataMap.containsKey(trimmedKey)
+ ? trimmedKey
+ : lowerKeyToOriginalKey.get(trimmedKey.toLowerCase());
+ if (matchedKey == null) {
+ continue;
+ }
+
+ Object value = dataMap.get(matchedKey);
+ appendTag(xml, trimmedKey, value, " ", keyOrderByTag, pureRootTagName + "/" + trimmedKey);
+ }
+
+ xml.append("\n");
+ } else {
+ String pureRootTagName = rootTagName.trim().split("\\s+")[0];
+ appendTag(xml, rootTagName, dataMap, "", keyOrderByTag, pureRootTagName);
+ }
+
+ return xml.toString();
+ } catch (Exception e) {
+ LCAP_LOGGER.error("实体 JSON 转 XML 失败: " + e.getMessage(), e);
+ throw new RuntimeException("实体 JSON 转 XML 失败", e);
+ }
+ }
+
+ private void appendTag(StringBuilder sb, String tagName, Object value, String indent, Map> keyOrderByTag, String path) {
+ String pureTagName = tagName.split("\\s+")[0];
+
+ if (value == null) {
+ sb.append(indent).append("<").append(tagName).append("/>\n");
+ return;
+ }
+
+ Object processingValue = value;
+
+ if (value instanceof String) {
+ String strVal = ((String) value).trim();
+ if ((strVal.startsWith("{") && strVal.endsWith("}")) || (strVal.startsWith("[") && strVal.endsWith("]"))) {
+ try {
+ processingValue = OBJECT_MAPPER.readValue(strVal, Object.class);
+ } catch (Exception ignored) {
+ }
+ }
+ }
+
+ if (processingValue instanceof Map) {
+ sb.append(indent).append("<").append(tagName).append(">\n");
+ Map map = (Map) processingValue;
+
+ List childKeyOrder = null;
+ if (keyOrderByTag != null && !keyOrderByTag.isEmpty()) {
+ childKeyOrder = keyOrderByTag.get(pureTagName);
+ if ((childKeyOrder == null || childKeyOrder.isEmpty()) && path != null && !path.isEmpty()) {
+ childKeyOrder = keyOrderByTag.get(path);
+ }
+ }
+
+ if (childKeyOrder != null && !childKeyOrder.isEmpty()) {
+ Map lowerKeyToOriginalKey = new HashMap<>();
+ for (Object keyObj : map.keySet()) {
+ if (keyObj == null) {
+ continue;
+ }
+ String keyStr = keyObj.toString();
+ lowerKeyToOriginalKey.putIfAbsent(keyStr.toLowerCase(), keyStr);
+ }
+
+ for (String key : childKeyOrder) {
+ if (key == null) {
+ continue;
+ }
+ String trimmedKey = key.trim();
+ if (trimmedKey.isEmpty()) {
+ continue;
+ }
+
+ Object matchedKeyObj = map.containsKey(trimmedKey) ? trimmedKey : lowerKeyToOriginalKey.get(trimmedKey.toLowerCase());
+ if (matchedKeyObj == null) {
+ continue;
+ }
+ Object childValue = map.get(matchedKeyObj);
+ appendTag(sb, trimmedKey, childValue, indent + " ", keyOrderByTag, pathJoin(path, trimmedKey));
+ }
+ } else {
+ for (Map.Entry entry : map.entrySet()) {
+ if (entry.getKey() != null) {
+ appendTag(sb, entry.getKey().toString(), entry.getValue(), indent + " ", keyOrderByTag, pathJoin(path, entry.getKey().toString()));
+ }
+ }
+ }
+ sb.append(indent).append("\n");
+ } else if (processingValue instanceof List) {
+ List list = (List) processingValue;
+ for (Object item : list) {
+ appendTag(sb, tagName, item, indent, keyOrderByTag, path);
+ }
+ } else {
+ sb.append(indent).append("<").append(tagName).append(">");
+ String valStr = escapeXml(processingValue.toString());
+ sb.append(valStr);
+ sb.append("\n");
+ }
+ }
+
+ private String pathJoin(String base, String child) {
+ if (base == null || base.trim().isEmpty()) {
+ return child;
+ }
+ if (child == null || child.trim().isEmpty()) {
+ return base;
+ }
+ return base + "/" + child.trim();
+ }
+
+ private String escapeXml(String str) {
+ if (str == null) return "";
+ return str.replace("&", "&")
+ .replace("<", "<")
+ .replace(">", ">")
+ .replace("\"", """)
+ .replace("'", "'");
+ }
+}
diff --git a/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlGeneratorUtilsService.java b/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlGeneratorUtilsService.java
new file mode 100644
index 000000000..452efe816
--- /dev/null
+++ b/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlGeneratorUtilsService.java
@@ -0,0 +1,215 @@
+package com.yourcompany.xml.generator.utils.api;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.netease.lowcode.core.annotation.NaslLogic;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Service;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 通用XML生成工具库
+ */
+@Service
+public class XmlGeneratorUtilsService {
+
+ private static final Logger LCAP_LOGGER = LoggerFactory.getLogger("LCAP_EXTENSION_LOGGER");
+ private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
+
+ /**
+ * 将Map数据转换为XML字符串
+ *
+ * @param data 包含数据的Map
+ * @param keyOrder Key 顺序列表
+ * @param keyOrderByTag 嵌套节点的子节点顺序配置（可为空）
+ * @param rootTagName 根节点名称 (如: Certificate)
+ * @return XML字符串
+ */
+ @NaslLogic
+ public String mapToXml(Map data, List keyOrder, Map> keyOrderByTag, String rootTagName) {
+ if (data == null) {
+ LCAP_LOGGER.error("输入数据 Map 为空");
+ return null;
+ }
+ if (rootTagName == null || rootTagName.isEmpty()) {
+ LCAP_LOGGER.error("根节点名称不能为空");
+ return null;
+ }
+
+ StringBuilder xml = new StringBuilder();
+ xml.append("\n");
+
+ if (keyOrder != null && !keyOrder.isEmpty()) {
+ LCAP_LOGGER.info("正在按照 Key 顺序生成 XML: " + keyOrder);
+
+ String pureTagName = rootTagName.trim().split("\\s+")[0];
+ xml.append("<").append(rootTagName).append(">\n");
+
+ Map lowerKeyToOriginalKey = new HashMap<>();
+ for (String key : data.keySet()) {
+ if (key == null) {
+ continue;
+ }
+ lowerKeyToOriginalKey.putIfAbsent(key.toLowerCase(), key);
+ }
+
+ for (String key : keyOrder) {
+ if (key == null) {
+ continue;
+ }
+ String trimmedKey = key.trim();
+
+ String matchedKey = data.containsKey(trimmedKey)
+ ? trimmedKey
+ : lowerKeyToOriginalKey.get(trimmedKey.toLowerCase());
+ if (matchedKey == null) {
+ continue;
+ }
+ String value = data.get(matchedKey);
+ appendTag(xml, trimmedKey, value, " ", keyOrderByTag, pureTagName + "/" + trimmedKey);
+ }
+
+ xml.append("\n");
+ } else {
+ LCAP_LOGGER.warn("Key 顺序列表为空，回退到默认 Map 遍历顺序。");
+ String pureTagName = rootTagName.trim().split("\\s+")[0];
+ appendTag(xml, rootTagName, data, "", keyOrderByTag, pureTagName);
+ }
+
+ return xml.toString();
+ }
+
+
+ private void appendTag(StringBuilder sb, String tagName, Object value, String indent, Map> keyOrderByTag, String path) {
+ String pureTagName = tagName.split("\\s+")[0];
+
+ if (value == null) {
+ sb.append(indent).append("<").append(tagName).append("/>\n");
+ return;
+ }
+
+ Object processingValue = value;
+
+ // 尝试解析字符串是否为 JSON 对象或数组
+ if (value instanceof String) {
+ String strVal = ((String) value).trim();
+ if ((strVal.startsWith("{") && strVal.endsWith("}")) || (strVal.startsWith("[") && strVal.endsWith("]"))) {
+ try {
+ // 尝试反序列化为对象 (Map 或 List)
+ Object parsed = OBJECT_MAPPER.readValue(strVal, Object.class);
+ processingValue = parsed;
+ } catch (Exception e) {
+ // 解析失败，视为普通字符串
+ // LCAP_LOGGER.warn("值看起来像 JSON 但解析失败: " + strVal);
+ }
+ }
+ }
+
+ if (processingValue instanceof Map) {
+ sb.append(indent).append("<").append(tagName).append(">\n");
+ Map map = (Map) processingValue;
+
+ List childKeyOrder = null;
+ if (keyOrderByTag != null && !keyOrderByTag.isEmpty()) {
+ childKeyOrder = keyOrderByTag.get(pureTagName);
+ if ((childKeyOrder == null || childKeyOrder.isEmpty()) && path != null && !path.isEmpty()) {
+ childKeyOrder = keyOrderByTag.get(path);
+ }
+ }
+
+ if (childKeyOrder != null && !childKeyOrder.isEmpty()) {
+ Map lowerKeyToOriginalKey = new HashMap<>();
+ for (Object keyObj : map.keySet()) {
+ if (keyObj == null) {
+ continue;
+ }
+ String keyStr = keyObj.toString();
+ lowerKeyToOriginalKey.putIfAbsent(keyStr.toLowerCase(), keyStr);
+ }
+
+ for (String key : childKeyOrder) {
+ if (key == null) {
+ continue;
+ }
+ String trimmedKey = key.trim();
+ if (trimmedKey.isEmpty()) {
+ continue;
+ }
+
+ Object matchedKeyObj = map.containsKey(trimmedKey) ? trimmedKey : lowerKeyToOriginalKey.get(trimmedKey.toLowerCase());
+ if (matchedKeyObj == null) {
+ continue;
+ }
+ Object childValue = map.get(matchedKeyObj);
+ appendTag(sb, trimmedKey, childValue, indent + " ", keyOrderByTag, pathJoin(path, trimmedKey));
+ }
+ } else {
+ for (Map.Entry entry : map.entrySet()) {
+ if (entry.getKey() != null) {
+ appendTag(sb, entry.getKey().toString(), entry.getValue(), indent + " ", keyOrderByTag, pathJoin(path, entry.getKey().toString()));
+ }
+ }
+ }
+ sb.append(indent).append("\n");
+ } else if (processingValue instanceof List) {
+ List list = (List) processingValue;
+ for (Object item : list) {
+ appendTag(sb, tagName, item, indent, keyOrderByTag, path);
+ }
+ } else {
+ sb.append(indent).append("<").append(tagName).append(">");
+ String valStr = processingValue.toString();
+ valStr = escapeXml(valStr);
+ sb.append(valStr);
+ sb.append("\n");
+ }
+ }
+
+ private String pathJoin(String base, String child) {
+ if (base == null || base.trim().isEmpty()) {
+ return child;
+ }
+ if (child == null || child.trim().isEmpty()) {
+ return base;
+ }
+ return base + "/" + child.trim();
+ }
+
+ private String escapeXml(String str) {
+ if (str == null) return "";
+ return str.replace("&", "&")
+ .replace("<", "<")
+ .replace(">", ">")
+ .replace("\"", """)
+ .replace("'", "'");
+ }
+
+ public static void main(String[] args) {
+ XmlGeneratorUtilsService service = new XmlGeneratorUtilsService();
+
+ Map inputMap = new java.util.HashMap<>();
+ inputMap.put("AplPromise", "{\"AplPromiseCode\":\"1\"}");
+ inputMap.put("ModCertificate", null);
+ inputMap.put("CertificateList", "{\"Goods\":[{\"HSCode\":\"290219\",\"GoodsItemFlag\":\"N\",\"GoodsName\":\"甲基环己烷\"}]}");
+ inputMap.put("CertificateHead", "{\"EntMgrNo\":\"333333053\",\"ApplyType\":\"0\",\"CertStatus\":\"0\",\"CertType\":\"C\",\"CertNo\":\"C251429459072741\"}");
+
+ List keyOrder = java.util.Arrays.asList("AplPromise", "ModCertificate", "CertificateHead", "CertificateList");
+
+ Map> keyOrderByTag = new java.util.HashMap<>();
+ keyOrderByTag.put("CertificateHead", java.util.Arrays.asList("CertNo", "ApplyType", "CertStatus", "CertType", "EntMgrNo"));
+ keyOrderByTag.put("CertificateList", java.util.Arrays.asList("Goods"));
+ keyOrderByTag.put("Goods", java.util.Arrays.asList("GoodsItemFlag", "HSCode", "GoodsName"));
+
+ String rootTagName = "Certificate xmlns=\"http://www.w3.org/2000/09/xmldsig#\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"http://www.w3.org/2000/09/xmldsig#Certificate.xsd\"";
+
+ System.out.println("=== Input Map ===");
+ System.out.println(inputMap);
+
+ System.out.println("\n=== Generated XML ===");
+ String xml = service.mapToXml(inputMap, keyOrder, keyOrderByTag, rootTagName);
+ System.out.println(xml);
+ }
+}
diff --git a/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlParseService.java b/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlParseService.java
new file mode 100644
index 000000000..ac87fd7f9
--- /dev/null
+++ b/xml-generator-utils/src/main/java/com/yourcompany/xml/generator/utils/api/XmlParseService.java
@@ -0,0 +1,58 @@
+package com.yourcompany.xml.generator.utils.api;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.MapperFeature;
+import com.fasterxml.jackson.dataformat.xml.XmlMapper;
+import com.netease.lowcode.core.annotation.NaslLogic;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Service;
+
+/**
+ * XML解析服务
+ * 提供将XML字符串转换为Java对象的功能
+ */
+@Service
+public class XmlParseService {
+
+ private static final Logger LCAP_LOGGER = LoggerFactory.getLogger("LCAP_EXTENSION_LOGGER");
+
+ private static final XmlMapper XML_MAPPER = new XmlMapper();
+
+ static {
+ // 配置忽略未知属性，增强容错性
+ XML_MAPPER.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
+ // 配置属性名称不区分大小写
+ XML_MAPPER.configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, true);
+ }
+
+ /**
+ * 通用XML解析 (反序列化)
+ * 将 XML 字符串转换回指定类型的 Java Bean
+ *
+ * @param xmlContent XML字符串内容
+ * @param clazz 目标类型的Class对象
+ * @param 泛型类型
+ * @return 转换后的Java对象
+ */
+ @NaslLogic
+ public T parseXml(String xmlContent, Class clazz) {
+ if (xmlContent == null) {
+ LCAP_LOGGER.error("XML解析失败: 输入内容为空");
+ throw new RuntimeException("XML解析失败: 输入内容为空");
+ }
+
+ try {
+ return XML_MAPPER.readValue(xmlContent, clazz);
+ } catch (JsonProcessingException e) {
+ String errorMsg = String.format("XML解析失败: 无法将内容转换为类型 [%s]. 错误信息: %s", clazz.getName(), e.getMessage());
+ LCAP_LOGGER.error(errorMsg, e);
+ throw new RuntimeException(errorMsg, e);
+ } catch (Exception e) {
+ String errorMsg = String.format("XML解析失败: 发生未知错误. 错误信息: %s", e.getMessage());
+ LCAP_LOGGER.error(errorMsg, e);
+ throw new RuntimeException(errorMsg, e);
+ }
+ }
+}
diff --git a/xml-generator-utils/src/main/resources/META-INF/spring.factories b/xml-generator-utils/src/main/resources/META-INF/spring.factories
new file mode 100644
index 000000000..7de295136
--- /dev/null
+++ b/xml-generator-utils/src/main/resources/META-INF/spring.factories
@@ -0,0 +1,2 @@
+org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
+com.yourcompany.xml.generator.utils.XmlGeneratorUtilsBasicSpringEnvironmentConfiguration
\ No newline at end of file