È possibile modificare a livello di programmazione nodi e proprietà situati all'interno dell'archivio di Adobe CQ , che fa parte dell'Adobe Marketing Cloud. Per accedere all'archivio CQ, utilizzate l'API Java Content Repository (JCR). Potete utilizzare l'API Java JCR per eseguire operazioni di creazione, sostituzione, aggiornamento ed eliminazione (CRUD) su contenuti che si trovano all'interno dell'archivio di Adobe CQ . Per ulteriori informazioni sull'API Java JCR, vedete https://jackrabbit.apache.org/jcr/jcr-api.html.
Questo articolo di sviluppo modifica il JCR Adobe CQ da un'applicazione Java esterna. Al contrario, potete modificare il JCR dall'interno di un bundle OSGi utilizzando l'API JCR. Per informazioni dettagliate, vedere Dati CQ persistenti in Java Content Repository.
Per utilizzare l'API JCR, aggiungete il file jackrabbit-standalone-2.4.0.jar
al percorso di classe dell'applicazione Java. Potete ottenere questo file JAR dalla pagina Web API Java JCR all'indirizzo https://jackrabbit.apache.org/jcr/jcr-api.html.
Per informazioni su come eseguire una query Adobe CQ JCR utilizzando l'API Query JCR, vedere Query dei dati Adobe Experience Manager tramite l'API JCR.
Anche se esistono diversi modi per connettersi a un repository e stabilire una connessione, questo articolo di sviluppo utilizza un metodo statico che appartiene alla classe org.apache.jackrabbit.commons.JcrUtils
. Il nome del metodo è getRepository
. Questo metodo richiede un parametro di stringa che rappresenta l'URL del server Adobe CQ . Esempio http://localhost:4503/crx/server
.
Il metodo getRepository
restituisce un'istanza Repository
come illustrato nell'esempio di codice seguente.
//Create a connection to the AEM JCR repository running on local host
Repository repository = JcrUtils.getRepository("http://localhost:4503/crx/server");
L'istanza Repository
rappresenta l'archivio CRX. L'istanza Repository
viene utilizzata per stabilire una sessione con la directory archivio. Per creare una sessione, richiamare il metodo Repository
dell'istanza login
e passare un oggetto javax.jcr.SimpleCredentials
. Il metodo login
restituisce un'istanza javax.jcr.Session
.
È possibile creare un oggetto SimpleCredentials
utilizzando il relativo costruttore e passando i seguenti valori stringa:
Quando si passa il secondo parametro, chiamare il metodo toCharArray
dell'oggetto String. Il codice seguente mostra come chiamare il metodo login
che restituisce un javax.jcr.Sessioninstance
.
//Create a Session instance
javax.jcr.Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()));
Utilizzare un'istanza Session
per creare un'istanza javax.jcr.Node
. Un'istanza Node
consente di eseguire operazioni sui nodi. Ad esempio, puoi creare un nuovo nodo. Per creare un nodo che rappresenta il nodo principale, invocare il metodo Session
dell'istanza getRootNode
, come illustrato nella riga di codice seguente.
//Create a Node
Node root = session.getRootNode();
Dopo aver creato un'istanza Node
è possibile eseguire attività quali la creazione di un altro nodo e l'aggiunta di un valore. Ad esempio, il codice seguente crea due nodi e aggiunge un valore al secondo nodo.
// Store content
Node day = adobe.addNode("day");
day.setProperty("message", "Adobe CQ is part of the Adobe Digital Marketing Suite!");
Per recuperare un nodo e il relativo valore, richiamare il metodo getNode
dell'istanza Node
e passare un valore di stringa che rappresenta il percorso completo del nodo. Considerare la struttura dei nodi creata nell'esempio di codice precedente. Per recuperare il nodo giorno, specificate adobe/day, come illustrato nel seguente codice:
// Retrieve content
Node node = root.getNode("adobe/day");
System.out.println(node.getPath());
System.out.println(node.getProperty("message").getString());
Il seguente esempio di codice Java rappresenta una classe Java che si connette a Adobe CQ, crea un'istanza Session
e aggiunge nuovi nodi. A un nodo viene assegnato un valore di dati, quindi il valore del nodo e il relativo percorso vengono scritti nella console. Al termine della sessione, disconnettetevi.
/*
* 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();
}
}
}
Dopo aver eseguito l'esempio di codice completo e creato i nodi, è possibile visualizzare i nuovi nodi nel CRXDE Lite, come illustrato nell'illustrazione seguente.