如何使用QueryBuilder API获取AEM资产的全部属性

我明白你现在的困扰：用QueryBuilder API查询资产时，要么只能拿到基础属性，要么只能拿到metadata里的属性，没法一次性获取所有内容。结合你设置的p.hits=full参数，有两种简单的方法可以解决这个问题：

方法1：直接从Hit对象获取所有属性 #

你已经设置了p.hits=full，这个参数会让QueryBuilder把资产节点及其所有子节点的属性都加载到Hit对象中，不需要额外遍历资源。直接通过hit.getValueMap()就能拿到所有属性，子节点的属性会以[父节点名].[属性名]的格式存在：

SearchResult result = query.getResult();
for (final Hit hit : result.getHits()) {
    // 获取包含所有层级属性的ValueMap
    ValueMap allProperties = hit.getValueMap();
    
    // 读取基础属性
    String assetPath = allProperties.get("jcr:path", String.class);
    String primaryType = allProperties.get("jcr:primaryType", String.class);
    
    // 读取metadata下的属性（格式为 jcr:content.metadata.[属性名]）
    String title = allProperties.get("jcr:content.metadata.dc:title", String.class);
    String creator = allProperties.get("jcr:content.metadata.dc:creator", String.class);
    
    // 如果需要Asset对象的其他方法，依然可以转换
    Asset asset = hit.getResource().adaptTo(Asset.class);
}

方法2：手动合并基础属性与Metadata属性 #

如果你更倾向于通过Resource/Asset对象操作，可以手动获取基础节点和metadata节点的属性，再合并成一个统一的ValueMap：

SearchResult result = query.getResult();
for (final Hit hit : result.getHits()) {
    Resource assetResource = hit.getResource();
    
    // 获取资产节点的基础属性
    ValueMap baseProps = assetResource.getValueMap();
    
    // 获取metadata子节点的属性（注意判空，避免空指针）
    Resource metadataResource = assetResource.getChild("jcr:content/metadata");
    ValueMap metadataProps = metadataResource != null ? metadataResource.getValueMap() : new ValueMapDecorator(new HashMap<>());
    
    // 合并两个ValueMap，CompositeValueMap会自动处理优先级
    ValueMap allProps = new CompositeValueMap(baseProps, metadataProps);
    
    // 现在可以统一读取所有属性了
    String path = allProps.get("jcr:path", String.class);
    String description = allProps.get("dc:description", String.class);
}

为什么之前的方法行不通？ #

• resource.getValueMap()默认只加载当前节点的属性，不会递归加载子节点（比如jcr:content/metadata）
• asset.getMetadata()是Asset API提供的便捷方法，专门用于读取jcr:content/metadata节点下的属性，所以不会包含基础节点的内容

最后提醒一下：你设置了p.limit=-1，如果资产数量很大，会导致内存占用过高，建议根据实际业务场景做分页处理哦。

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