Anleitung für den programmgesteuerten Zugriff auf das AEM-JCR

Sie können programmgesteuert Knoten und Eigenschaften ändern, die sich innerhalb des Adobe CQ-Repositorys befinden, das Teil von Adobe Marketing Cloud ist. Für den Zugriff auf das CQ-Repository verwenden Sie die Java Content Repository (JCR)-API. Mit der JCR-API können Sie Erstellungs-, Ersetzungs-, Aktualisierungs- und Lösch- (CRUD)-Vorgänge für Inhalte im Adobe CQ-Repository durchführen. Weitere Informationen zur Java JCR-API finden Sie unter https://jackrabbit.apache.org/jcr/jcr-api.html.

HINWEIS

Dieser Entwicklungsartikel modifiziert das Adobe CQ-JCR aus einer externen Java-Anwendung. Es besteht auch die Möglichkeit, das JCR aus einem OSGi-Bundle mithilfe der JCR-API zu modifizieren. Weitere Informationen finden Sie unter Beständige CQ-Daten im Java Content Repository.

HINWEIS

Um die JCR-API zu verwenden, fügen Sie die Datei jackrabbit-standalone-2.4.0.jar dem Klassenpfad Ihrer Java-Anwendung hinzu. Sie können diese JAR-Datei von der Java JCR API-Webseite unter https://jackrabbit.apache.org/jcr/jcr-api.html abrufen.

HINWEIS

Eine Anleitung zur Abfrage des Adobe CQ-JCR mithilfe der JCR-Abfrage-API finden Sie in Abfragen von Adobe Experience Manager-Daten mit der JCR-API.

Repository-Instanz erstellen

Es gibt unterschiedliche Verfahren zur Herstellung einer Verbindung mit einem Repository. In diesem Entwicklungsartikel wird eine statische Methode verwendet, die der Klasse org.apache.jackrabbit.commons.JcrUtils zuzuordnen ist. Der Name der Methode lautet getRepository. Diese Methode verwendet einen Zeichenfolgenparameter, der die URL des Adobe CQ-Servers darstellt. Beispiel http://localhost:4503/crx/server.

Die Methode getRepository gibt eine Repository-Instanz zurück, was im folgenden Codebeispiel veranschaulicht wird.

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

Sitzungsinstanz erstellen

Die RepositoryInstanz stellt das CRX-Repository dar. Sie verwenden die RepositoryInstanz, um eine Sitzung mit dem Repository einzurichten. Um eine Sitzung zu erstellen, rufen Sie die RepositoryInstanz's loginMethode auf und übergeben Sie ein javax.jcr.SimpleCredentials-Objekt. Die loginMethode gibt eine javax.jcr.Session-Instanz zurück.

Sie erstellen ein SimpleCredentialsObjekt, indem Sie dessen Konstruktor verwenden und die folgenden Zeichenfolgenwerte übergeben:

  • den Benutzernamen und
  • das zugehörige Kennwort

Rufen Sie beim Übergeben des zweiten Parameters die toCharArrayMethode des String-Objekts auf. Der folgende Code zeigt, wie die loginMethode aufgerufen wird, die ein javax.jcr.Sessioninstance zurückgibt.

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

Knoteninstanz erstellen

Verwenden Sie eine SessionInstanz, um eine javax.jcr.Node-Instanz zu erstellen. Mit einer NodeInstanz können Sie Node-Vorgänge durchführen. Beispielsweise können Sie einen neuen Knoten erstellen. Um einen Knoten zu erstellen, der den Stammknoten darstellt, rufen Sie die SessionInstanz-Methode getRootNode auf, wie in der folgenden Codezeile dargestellt.

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

Nachdem Sie eine NodeInstanz erstellt haben, können Sie Aufgaben wie das Erstellen eines anderen Knotens und das Hinzufügen eines Werts ausführen. Mit dem folgenden Code werden beispielsweise zwei Knoten erstellt und dem zweiten Knoten ein Wert hinzugefügt.

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

Knotenwerte abrufen

Um eine Node und ihren Wert abzurufen, rufen Sie die NodeInstanzmethode getNodeauf und übergeben Sie einen Zeichenfolgenwert, der den vollständig qualifizierten Pfad zur Node darstellt. Betrachten Sie die Knotenstruktur, die im vorherigen Codebeispiel erstellt wurde. Zum Abrufen des Tagesknotens geben Sie „adobe/day“ an, wie das folgende Codebeispiel zeigt:

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

Knoten im Adobe CQ-Repository erstellen

Das folgende Java-Codebeispiel stellt eine Java-Klasse dar, die eine Verbindung zu Adobe CQ herstellt, eine SessionInstanz erstellt und neue Knoten hinzufügt. Einem Knoten wird ein Datenwert zugewiesen, woraufhin der Wert des Knotens und seines Pfades aus der Konsole geschrieben wird. Wenn Sie die Sitzung abgeschlossen haben, melden Sie sich unbedingt ab.

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

Nachdem Sie das vollständige Codebeispiel ausgeführt und die Nodes erstellt haben, können Sie die neuen Nodes in der CRXDE Lite a1/> Ansicht haben, wie in der folgenden Abbildung dargestellt.

chlimage_1-68

Auf dieser Seite