Show Menu
SUJETS×

Mise en œuvre d’un évaluateur de prédicat personnalisé pour Query Builder.

Cette section décrit comment étendre Query Builder en mettant en œuvre un évaluateur de prédicat personnalisé.

Présentation

Query Builder offre un moyen simple pour effectuer des requêtes sur le référentiel de contenu. AEM est livré avec un ensemble d’évaluateurs de prédicats qui vous aide à traiter vos données.
Toutefois, vous pouvez simplifier vos requêtes en mettant en œuvre un évaluateur de prédicat personnalisé qui masque une partie de la complexité et assure une meilleure sémantique.
Un prédicat personnalisé peut également réaliser d’autres actions qui ne sont pas directement possibles avec XPath, par exemple :
  • Recherche de certaines données d’un service donné
  • Filtrage personnalisé basé sur le calcul
Les problèmes de performances doivent être pris en compte lors de la mise en œuvre d’un prédicat personnalisé.
Vous trouverez des exemples de requêtes dans la section Query Builder .
CODE SUR GITHUB
Vous pouvez trouver le code de cette page sur GitHub.

L’évaluateur de prédicat en détail

Un évaluateur de prédicat gère l’évaluation de certains prédicats, qui constituent les contraintes définissant une requête.
Il mappe une contrainte de recherche de plus haut niveau (par exemple, « width > 200 ») sur une requête JCR spécifique qui est adaptée au modèle de contenu actuel (par exemple, metadata/@width > 200). Il peut également filtrer manuellement les nœuds et vérifier leurs contraintes.
Pour plus d’informations sur PredicateEvaluator et le module com.day.cq.search , voir la documentation Java .

Mise en œuvre d’un évaluateur de prédicat personnalisé pour les métadonnées de réplication

À titre d’exemple, cette section explique comment créer un évaluateur de prédicats personnalisé qui aide les données en fonction des métadonnées de réplication :
  • cq:lastReplicated qui stocke la date de la dernière action de réplication.
  • cq:lastReplicatedBy qui stocke l’ID de l’utilisateur qui a déclenché la dernière action de réplication.
  • cq:lastReplicationAction qui stocke la dernière action de réplication (par exemple, activation ou désactivation).

Requête sur les métadonnées de réplication avec les évaluateurs de prédicats par défaut

The following query fetches the list of nodes in /content branch that have been activated by admin since the beginning of the year.
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=>=

Cette requête est valide, mais peu lisible et ne met pas en évidence la relation entre les trois propriétés de réplication. L’implémentation d’un évaluateur de prédicats personnalisé réduira la complexité et améliorera la sémantique de cette requête.

Objectifs

L’objectif de ReplicationPredicateEvaluator consiste à prendre en charge la requête ci-dessus à l’aide de la syntaxe ci-après.
path=/content

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

Le regroupement des prédicats de métadonnées de réplication avec un évaluateur de prédicats personnalisé permet de créer une requête significative.

Mise à jour des dépendances Maven

La configuration de nouveaux projets AEM à l’aide de Maven est décrite dans Création de projets AEM à l’aide d’Apache Maven .
Tout d’abord, vous devez mettre à jour les dépendances Maven de votre projet. PredicateEvaluator fait partie de l’artefact cq-search et doit donc être ajouté à votre fichier pom Maven.
The scope of the cq-search dependency is set to provided because cq-search will be provided by the OSGi container.
pom.xml
The following snippet shows the differences, in unified diff format
@@ -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>

Écriture de ReplicationpredicateEvaluator

The cq-search project contains the AbstractPredicateEvaluator abstract class. This can be extended with a few steps to implement your own custom predicate evaluator (PredicateEvaluator ).
La procédure suivante explique comment créer une expression Xpath afin de filtrer des données. Another option would be to implement the includes method that selects data on a row basis. Pour plus d’informations, voir la documentation Java .
  1. Créez une classe Java qui étend com.day.cq.search.eval.AbstractPredicateEvaluator .
  2. Annotate your class with a @Component like the following
    src/main/java/com/adobe/aem/docs/search/ReplicationPredicateEvaluator.java
    The following snippet shows the differences, in unified diff format
@@ -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 {

  }

The factory must be a unique string starting with com.day.cq.search.eval.PredicateEvaluator/ and ending with the name of your custom PredicateEvaluator .
Le nom de PredicateEvaluator est le nom du prédicat, qui est utilisé pour créer des requêtes.
  1. Remplacement :
    public String getXPathExpression(Predicate predicate, EvaluationContext context)
    
    
    In the override method you build a Xpath expression based on the Predicate given in argument.

Exemple d’évaluateur de prédicat personnalisé pour les métadonnées de réplication

La mise en œuvre complète de ce PredicateEvaluator peut être semblable à la classe suivante.
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
 *
 *      http://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 ");

        }

    }

}