使用Sling Post Servlet创建页面时节点顺序与JSON不一致的解决建议

• 先明确核心原因：JCR（Oak/Jackrabbit）默认以无序方式存储节点属性和子节点，Sling Post Servlet默认解析JSON时用的是普通HashMap这类不保证顺序的集合，直接导致生成节点的顺序和原始JSON不一致。

• 改用有序集合解析JSON
  如果是自定义扩展Post Servlet的场景，解析JSON时使用LinkedHashMap来保留键的顺序。比如用Jackson解析时的配置：

  ObjectMapper mapper = new ObjectMapper();
  // 指定用LinkedHashMap解析，保留JSON原顺序
  TypeReference<LinkedHashMap<String, Object>> orderedMapType = new TypeReference<>() {};
  LinkedHashMap<String, Object> jsonData = mapper.readValue(jsonInput, orderedMapType);
  

  后续基于这个有序Map来创建节点，就能保证顺序和JSON一致。

• 利用jcr:orderBefore属性控制顺序
  若直接使用Sling默认Post机制，可在JSON中给子节点添加jcr:orderBefore属性来强制指定顺序。示例JSON结构：

  {
    "jcr:primaryType": "cq:PageContent",
    "banner": {
      "jcr:primaryType": "nt:unstructured",
      "title": "首页横幅"
    },
    "content": {
      "jcr:primaryType": "nt:unstructured",
      "jcr:orderBefore": "sidebar",
      "text": "正文内容"
    },
    "sidebar": {
      "jcr:primaryType": "nt:unstructured",
      "links": ["链接1", "链接2"]
    }
  }
  

  这里通过给content节点设置jcr:orderBefore": "sidebar"，确保它在sidebar节点之前生成。

• 自定义Sling Post Processor调整顺序
  实现SlingPostProcessor接口，在节点创建完成后，根据原始JSON的顺序重新调整节点排序。核心代码示例：

  @Component(service = SlingPostProcessor.class)
  public class OrderedNodePostProcessor implements SlingPostProcessor {
  
      @Override
      public void process(SlingHttpServletRequest request, List<Modification> modifications) throws Exception {
          Resource targetResource = request.getResource();
          Node parentNode = targetResource.adaptTo(Node.class);
          if (parentNode == null) return;
  
          // 从request中获取原始JSON并解析出有序的子节点名称列表
          String rawJson = request.getParameter(":content");
          ObjectMapper mapper = new ObjectMapper();
          LinkedHashMap<String, Object> jsonMap = mapper.readValue(rawJson, new TypeReference<>() {});
          List<String> orderedChildNames = jsonMap.keySet().stream()
                  .filter(key -> !key.startsWith("jcr:"))
                  .collect(Collectors.toList());
  
          // 按顺序调整节点位置
          for (int i = 1; i < orderedChildNames.size(); i++) {
              String currentNodeName = orderedChildNames.get(i);
              String prevNodeName = orderedChildNames.get(i-1);
              parentNode.orderBefore(currentNodeName, prevNodeName);
          }
      }
  }
  

  这个processor会在Post操作完成后，根据原始JSON的键顺序重新排列子节点。

• 检查节点类型的可排序性
  确保你使用的节点类型（比如自定义节点类型）支持排序，需要在节点类型定义中添加orderable属性。比如Oak中自定义节点类型的配置片段：

  <nodeType name="myapp:content" orderable="true">
      <supertypes>
          <supertype>nt:unstructured</supertype>
      </supertypes>
  </nodeType>
  

内容的提问来源于stack exchange，提问作者user3676024