为查询生成器实施自定义谓词计算器

本节介绍如何扩展查询生成器实现自定义谓词求值器。

概述

此查询生成器提供了一种查询内容存储库的简单方法。 CQ附带了一组谓词评估器，可帮助您处理数据。

但是，您可能希望通过实施自定义谓词计算器来简化查询，该计算器可隐藏一些复杂性并确保更好的语义。

自定义谓词还可以执行使用XPath无法直接执行的其他操作，例如：

从某个服务中查找一些数据
基于计算的自定义筛选

注意

实施自定义谓词时必须考虑性能问题。

注意

您可以在以下位置找到查询示例查询生成器部分。

GITHUB上的代码

您可以在GitHub上找到此页面的代码

在GitHub上打开aem-search-custom-predicate-evaluator项目
将项目下载为 ZIP文件

谓词计算器详细信息

谓词计算器处理某些谓词的计算，这些谓词是查询的定义约束。

它将更高级别的搜索限制（例如“宽度> 200”）映射到适合实际内容模型的特定JCR查询(例如，元数据/@width > 200)。或者，它可以手动筛选节点并检查其约束。

注意

欲知关于 PredicateEvaluator 和 com.day.cq.search 包请参阅 Java文档.

实施复制元数据的自定义谓词求值器

作为示例，本节将介绍如何创建自定义谓词计算器，以帮助基于复制元数据的数据：

cq:lastReplicated 存储上次复制操作的日期
cq:lastReplicatedBy 用于存储触发上次复制操作的用户的id
cq:lastReplicationAction 存储上次复制操作（例如，激活、停用）的用户

使用默认谓词求值器查询复制元数据

以下查询获取中的节点列表 /content 已由激活的分支 admin 从年初开始。

path=/content

1_property=cq:lastReplicatedBy
1_property.value=admin

2_property=cq:lastReplicationAction
2_property.value=Activate

daterange.property=cq:lastReplicated
daterange.lowerBound=2013-01-01T00:00:00.000+01:00
daterange.lowerOperation=>=

此查询有效，但难以读取，并且不会突出显示三个复制属性之间的关系。实施自定义谓词求值器将降低此查询的复杂性并提高其语义。

目标

的目标 ReplicationPredicateEvaluator ，以使用以下语法支持上述查询。

path=/content

replic.by=admin
replic.since=2013-01-01T00:00:00.000+01:00
replic.action=Activate

使用自定义谓词计算器将复制元数据谓词分组有助于创建有意义的查询。

更新Maven依赖项

注意

以下文档介绍了使用maven设置新的AEM项目如何使用Apache Maven构建AEM项目.

首先，您需要更新项目的Maven依赖项。此 PredicateEvaluator 是 cq-search 工件，因此需要将其添加到您的Maven pom文件中。

注意

范围 cq-search 依赖关系设置为 provided 因为 cq-search 将由 OSGi 容器。

pom.xml

以下代码片段显示了两者在统一差异格式

@@ -120,6 +120,12 @@
             <scope>provided</scope>
         <dependency>
+            <groupid>com.day.cq</groupid>
+            <artifactid>cq-search</artifactid>
+            <version>5.6.4</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
             <groupid>junit</groupid>
             <artifactid>junit</artifactid>
             <version>3.8.1</version></dependency>

aem-search-custom-predicate-evaluator- pom.xml

编写ReplicationPredicateEvaluator

此 cq-search 项目包含 AbstractPredicateEvaluator 抽象类。只需几个步骤即可扩展此功能以实施您自己的自定义谓词计算器 (PredicateEvaluator)。

注意

以下过程说明如何构建 Xpath 用于筛选数据的表达式。另一种选择是实施 includes 逐行选择数据的方法。请参阅 Java文档了解更多信息。

创建扩展的Java类 com.day.cq.search.eval.AbstractPredicateEvaluator
使用为课程添加批注 @Component 如下所示

src/main/java/com/adobe/aem/docs/search/ReplicationPredicateEvaluator.java

以下代码片段显示了两者在统一差异格式

@@ -19,8 +19,11 @@
  */
 package com.adobe.aem.docs.search;

+import org.apache.felix.scr.annotations.Component;
+
 import com.day.cq.search.eval.AbstractPredicateEvaluator;

+@Component(metatype = false, factory = "com.day.cq.search.eval.PredicateEvaluator/repli")
 public class ReplicationPredicateEvaluator extends AbstractPredicateEvaluator {

 }

aem-search-custom-predicate-evaluator- src/main/java/com/adobe/aem/docs/search/ReplicationPredicateEvaluator.java

注意

此 factory必须为以开头的唯一字符串 com.day.cq.search.eval.PredicateEvaluator/并以您的自定义名称结尾 PredicateEvaluator.

注意

的名称 PredicateEvaluator 是谓词名称，在构建查询时使用。

替代:
```
public String getXPathExpression(Predicate predicate, EvaluationContext context)
```
在覆盖方法中，您构建 Xpath 表达式基于 Predicate 在论据中给出。

复制元数据的自定义谓词计算器示例

此功能的完整实施 PredicateEvaluator 可能类似于以下类。

src/main/java/com/adobe/aem/docs/search/ReplicationPredicateEvaluator.java

/*
 * #%L
 * aem-docs-custom-predicate-evaluator
 * %%
 * Copyright (C) 2013 Adobe Research
 * %%
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * #L%
 */

package com.adobe.aem.docs.search;

import org.apache.felix.scr.annotations.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.day.cq.search.Predicate;
import com.day.cq.search.eval.AbstractPredicateEvaluator;
import com.day.cq.search.eval.EvaluationContext;

@Component(metatype = false, factory = "com.day.cq.search.eval.PredicateEvaluator/repli")

public class ReplicationPredicateEvaluator extends AbstractPredicateEvaluator {

    static final String PE_NAME = "replic";


    static final String PN_LAST_REPLICATED_BY = "cq:lastReplicatedBy";
    static final String PN_LAST_REPLICATED = "cq:lastReplicated";
    static final String PN_LAST_REPLICATED_ACTION = "cq:lastReplicationAction";

    static final String PREDICATE_BY = "by";
    static final String PREDICATE_SINCE = "since";
    static final String PREDICATE_SINCE_OP = " >= ";
    static final String PREDICATE_ACTION = "action";

    Logger log = LoggerFactory.getLogger(getClass());

    /**
     * Returns a XPath expression filtering by replication metadata.
     *
     * @see com.day.cq.search.eval.AbstractPredicateEvaluator#getXPathExpression(com.day.cq.search.Predicate,
     *      com.day.cq.search.eval.EvaluationContext)
     */

    @Override

    public String getXPathExpression(Predicate predicate,
            EvaluationContext context) {

        log.debug("predicate {}", predicate);

        String date = predicate.get(PREDICATE_SINCE);
        String user = predicate.get(PREDICATE_BY);
        String action = predicate.get(PREDICATE_ACTION);

        StringBuilder sb = new StringBuilder();

        if (date != null) {

            sb.append(PN_LAST_REPLICATED).append(PREDICATE_SINCE_OP);
            sb.append("xs:dateTime('").append(date).append("')");

        }

        if (user != null) {

            addAndOperator(sb);
            sb.append(PN_LAST_REPLICATED_BY);
            sb.append("='").append(user).append("'");

        }

        if (action != null) {

            addAndOperator(sb);
            sb.append(PN_LAST_REPLICATED_ACTION);
            sb.append("='").append(action).append("'");

        }

        String xpath = sb.toString();

        log.debug("xpath **{}**", xpath);

        return xpath;

    }

    /**
     * Add an and operator if the builder is not empty.
     *
     * @param sb a {@link StringBuilder} containing the query under construction
     */

    private void addAndOperator(StringBuilder sb) {

        if (sb.length() != 0) {

            sb.append(" and ");

        }

    }

}

aem-search-custom-predicate-evaluator- src/main/java/com/adobe/aem/docs/search/ReplicationPredicateEvaluator.java

Business.Adobe.com 资源

Multichannel Communication Ecommerce Integrations Personalized Experiences Theme Editor Dynamic Media Digital Asset Management

为查询生成器实施自定义谓词计算器

概述

谓词计算器详细信息

实施复制元数据的自定义谓词求值器

使用默认谓词求值器查询复制元数据

目标

更新Maven依赖项

编写ReplicationPredicateEvaluator

复制元数据的自定义谓词计算器示例

Business.Adobe.com 资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe