Cómo acceder mediante programación al JCR de AEM

Puede modificar mediante programación nodos y propiedades ubicados dentro del repositorio de Adobe CQ, que forma parte de Adobe Marketing Cloud. Para acceder al repositorio de CQ, utiliza la API del repositorio de contenido Java (JCR). Puede utilizar la API JCR de Java para realizar operaciones de creación, sustitución, actualización y eliminación (CRUD) en contenido ubicado dentro del repositorio de Adobe CQ. Para obtener más información sobre la API de JCR de Java, consulte https://jackrabbit.apache.org/jcr/jcr-api.html.

NOTA

Este artículo de desarrollo modifica el JCR de Adobe CQ de una aplicación Java externa. Por el contrario, puede modificar el JCR desde un paquete OSGi mediante la API JCR. Para obtener más información, consulte Persistencia de datos de CQ en el repositorio de contenido Java.

NOTA

Para utilizar la API de JCR, agregue la variable jackrabbit-standalone-2.4.0.jar a la ruta de clase de su aplicación Java. Puede obtener este archivo JAR desde la página web de la API de Java JCR en https://jackrabbit.apache.org/jcr/jcr-api.html.

NOTA

Para obtener información sobre cómo consultar el JCR de Adobe CQ mediante la API de consulta JCR, consulte Consulta de datos de Adobe Experience Manager mediante la API de JCR.

Crear una instancia de repositorio

Aunque hay diferentes formas de conectarse a un repositorio y establecer una conexión, este artículo de desarrollo utiliza un método estático que pertenece al org.apache.jackrabbit.commons.JcrUtils Clase . El nombre del método es getRepository. Este método emplea un parámetro de cadena que representa la dirección URL del servidor de Adobe CQ. Por ejemplo http://localhost:4503/crx/server.

La variable getRepositoryel método devuelve un Repositorycomo se muestra en el siguiente ejemplo de código.

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

Crear una instancia de sesión

La variable Repositoryrepresenta el repositorio CRX. Utilice la variable Repositorypara establecer una sesión con el repositorio. Para crear una sesión, invoque la función Repositorydel loginmétodo y pasar una javax.jcr.SimpleCredentials objeto. La variable loginel método devuelve un javax.jcr.Session instancia.

Puede crear un SimpleCredentialsusando su constructor y pasando los siguientes valores de cadena:

  • El nombre de usuario;
  • La contraseña correspondiente

Al pasar el segundo parámetro, llame al objeto String toCharArraymétodo. El siguiente código muestra cómo llamar a la función loginmétodo que devuelve un javax.jcr.Sessioninstance.

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

Crear una instancia de nodo

Utilice un Sessionpara crear una javax.jcr.Node instancia. A Nodeinstance permite realizar operaciones de nodos. Por ejemplo, puede crear un nuevo nodo. Para crear un nodo que represente el nodo raíz, invoque la variable Sessioninstance's getRootNode como se muestra en la siguiente línea de código.

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

Una vez que haya creado una Node, puede realizar tareas como crear otro nodo y añadir un valor a él. Por ejemplo, el siguiente código crea dos nodos y añade un valor al segundo nodo.

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

Recuperar valores de nodo

Para recuperar un nodo y su valor, invoque la variable Nodedel getNodey pase un valor de cadena que represente la ruta completa al nodo. Tenga en cuenta la estructura de nodos creada en el ejemplo de código anterior. Para recuperar el nodo del día, especifique adobe/day, como se muestra en el siguiente código:

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

Creación de nodos en el repositorio de Adobe CQ

El siguiente ejemplo de código Java representa una clase Java que se conecta a Adobe CQ y crea una Sessiony añade nuevos nodos. A un nodo se le asigna un valor de datos y, a continuación, el valor del nodo y su ruta se escriben en la consola. Cuando haya terminado con la sesión, asegúrese de cerrar la sesión.

/*
 * 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();
  }
 }
}

Después de ejecutar el ejemplo de código completo y crear los nodos, puede ver los nuevos nodos en la variable CRXDE Lite, como se muestra en la siguiente ilustración.

chlimage_1-68

En esta página