Comment accéder au JCR AEM par programmation how-to-programmatically-access-the-aem-jcr

Vous pouvez modifier par programme les nœuds et les propriétés situés dans le référentiel Adobe CQ, qui fait partie d’Adobe Experience Cloud. Pour accéder au référentiel CQ, vous utilisez l’API Java™ Content Repository (JCR). Vous pouvez utiliser l’API Java™ JCR pour créer, remplacer, mettre à jour et supprimer du contenu (CRUD) situé dans le référentiel Adobe CQ. Pour plus d’informations sur l’API JCR Java™, consultez https://jackrabbit.apache.org/jcr/jcr-api.html.

Créer une instance de référentiel create-a-repository-instance

Cet article de développement fait appel à une méthode statique appartenant à la classe org.apache.jackrabbit.commons.JcrUtils pour se connecter à un référentiel et établir une connexion. Il existe cependant d’autres modus operandi. Cette méthode se nomme getRepository. Dans ce cas, un paramètre de chaîne est utilisé, qui représente l’URL du serveur Adobe CQ. Par exemple, http://localhost:4503/crx/server.

La variable getRepository renvoie une Repository , comme illustré dans l’exemple de code suivant.

//Create a connection to the AEM JCR repository running on local host
Repository repository = JcrUtils.getRepository("http://localhost:4503/crx/server");

Création d’une instance de session create-a-session-instance

La variable Repository représente le référentiel CRX. Vous utilisez la variable Repository pour établir une session avec le référentiel. Pour créer une session, appelez le Repository instance login et transmettre une javax.jcr.SimpleCredentials . La variable login renvoie une javax.jcr.Session instance.

Vous créez une SimpleCredentials en utilisant son constructeur et en transmettant les valeurs string suivantes :

Lors de la transmission du second paramètre, appelez le toCharArray . Le code suivant indique comment appeler la fonction login qui renvoie une javax.jcr.Sessioninstance.

//Create a Session instance
javax.jcr.Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()));

Création d’une instance de nœud create-a-node-instance

Utilisez une Session pour créer une instance javax.jcr.Node instance. A Node vous permet d’effectuer des opérations sur les noeuds. Vous pouvez, par exemple, créer un nœud. Pour créer un noeud qui représente le noeud racine, appelez la méthode Session instance getRootNode , comme illustré dans la ligne de code suivante.

//Create a Node
Node root = session.getRootNode();

Une fois que vous avez créé une Node vous pouvez exécuter des tâches telles que la création d’un autre noeud et l’ajout d’une valeur. Par exemple, le code suivant crée deux nœuds et ajoute une valeur au deuxième nœud.

// Store content
Node day = adobe.addNode("day");
day.setProperty("message", "Adobe CQ is part of the Adobe Digital Marketing Suite!");

Récupérer les valeurs des nœuds retrieve-node-values

Pour récupérer un noeud et sa valeur, appelez la méthode Node instance getNode et transmettez une valeur string qui représente le chemin d’accès complet au noeud. Considérez la structure de nœuds créée dans l’exemple de code précédent. Pour récupérer le nœud day, spécifiez adobe/day, comme indiqué dans le code suivant :

// Retrieve content
Node node = root.getNode("adobe/day");
System.out.println(node.getPath());
System.out.println(node.getProperty("message").getString());

Créer des nœuds dans le référentiel Adobe CQ create-nodes-in-the-adobe-cq-repository

L’exemple de code Java™ suivant représente une classe Java™ qui se connecte à Adobe CQ, crée une Session et ajoute de nouveaux noeuds. Une valeur de données est affectée au nœud, puis la valeur du nœud et son chemin d’accès sont écrits sur la console. Lorsque vous en avez terminé avec l’instance Session, veillez à vous déconnecter.

/*
 * This Java Quick Start uses the jackrabbit-standalone-2.4.0.jar
 * file. See the previous section for the location of this JAR file
 */

import javax.jcr.Repository;
import javax.jcr.Session;
import javax.jcr.SimpleCredentials;
import javax.jcr.Node;

import org.apache.jackrabbit.commons.JcrUtils;
import org.apache.jackrabbit.core.TransientRepository;

public class GetRepository {

public static void main(String[] args) throws Exception {

try {

    //Create a connection to the CQ repository running on local host
    Repository repository = JcrUtils.getRepository("http://localhost:4503/crx/server");

   //Create a Session
   javax.jcr.Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()));

  //Create a node that represents the root node
  Node root = session.getRootNode();

  // Store content
  Node adobe = root.addNode("adobe");
  Node day = adobe.addNode("day");
  day.setProperty("message", "Adobe CQ is part of the Adobe Digital Marketing Suite!");

  // Retrieve content
  Node node = root.getNode("adobe/day");
  System.out.println(node.getPath());
  System.out.println(node.getProperty("message").getString());

  // Save the session changes and log out
  session.save();
  session.logout();
  }
 catch(Exception e){
  e.printStackTrace();
  }
 }
}

Après avoir exécuté l’exemple de code complet et créé les nœuds, vous pouvez afficher les nouveaux nœuds dans CRXDE Lite, comme illustré ci-dessous.