Você pode modificar programaticamente os nós e as propriedades localizados no repositório Adobe CQ, que faz parte da Adobe Marketing Cloud. Para acessar o repositório do CQ, use a API Java Content Repository (JCR). Você pode usar a Java JCR API para executar operações de criação, substituição, atualização e exclusão (CRUD) em conteúdo localizado no repositório Adobe CQ. Para obter mais informações sobre a API Java JCR, consulte https://jackrabbit.apache.org/jcr/jcr-api.html.
Este artigo de desenvolvimento modifica o Adobe CQ JCR de um aplicativo Java externo. Por outro lado, você pode modificar o JCR de um pacote OSGi usando a API JCR. Para obter detalhes, consulte Dados CQ persistentes no repositório de conteúdo Java.
Para usar a API JCR, adicione o arquivo jackrabbit-standalone-2.4.0.jar
ao caminho de classe do seu aplicativo Java. Você pode obter esse arquivo JAR da página da API JCR Java em https://jackrabbit.apache.org/jcr/jcr-api.html.
Para saber como query o Adobe CQ JCR usando a API do Query JCR, consulte Consultando dados do Adobe Experience Manager usando a API do JCR.
Embora existam diferentes maneiras de se conectar a um repositório e estabelecer uma conexão, este artigo de desenvolvimento usa um método estático que pertence à classe org.apache.jackrabbit.commons.JcrUtils
. O nome do método é getRepository
. Esse método usa um parâmetro de string que representa a URL do servidor Adobe CQ. Por exemplo http://localhost:4503/crx/server
.
O método getRepository
retorna uma instância Repository
conforme mostrado no exemplo de código a seguir.
//Create a connection to the AEM JCR repository running on local host
Repository repository = JcrUtils.getRepository("http://localhost:4503/crx/server");
A instância Repository
representa o repositório CRX. Use a instância Repository
para estabelecer uma sessão com o repositório. Para criar uma sessão, chame o método Repository
da instância e transmita um objeto javax.jcr.SimpleCredentials
. login
O método login
retorna uma instância javax.jcr.Session
.
Você cria um objeto SimpleCredentials
usando seu construtor e transmitindo os seguintes valores de string:
Ao transmitir o segundo parâmetro, chame o método toCharArray
do objeto String. O código a seguir mostra como chamar o método login
que retorna um javax.jcr.Sessioninstance
.
//Create a Session instance
javax.jcr.Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()));
Use uma instância Session
para criar uma instância javax.jcr.Node
. Uma instância Node
permite executar operações de nó. Por exemplo, você pode criar um novo nó. Para criar um nó que represente o nó raiz, chame o método Session
da instância getRootNode
, conforme mostrado na seguinte linha de código.
//Create a Node
Node root = session.getRootNode();
Depois de criar uma instância Node
, você pode executar tarefas como criar outro nó e adicionar um valor a ele. Por exemplo, o código a seguir cria dois nós e adiciona um valor ao segundo nó.
// Store content
Node day = adobe.addNode("day");
day.setProperty("message", "Adobe CQ is part of the Adobe Digital Marketing Suite!");
Para recuperar um nó e seu valor, chame o método Node
da instância e transmita um valor de string que representa o caminho totalmente qualificado para o nó. getNode
Considere a estrutura de nó criada no exemplo de código anterior. Para recuperar o nó do dia, especifique adobe/day, como mostrado no seguinte código:
// Retrieve content
Node node = root.getNode("adobe/day");
System.out.println(node.getPath());
System.out.println(node.getProperty("message").getString());
O exemplo de código Java a seguir representa uma classe Java que se conecta ao Adobe CQ, cria uma Session
instância e adiciona novos nós. Um nó recebe um valor de dados e o valor do nó e seu caminho é gravado no console. Quando terminar a sessão, faça logoff.
/*
* 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();
}
}
}
Depois de executar o exemplo de código completo e criar os nós, você pode visualização os novos nós em CRXDE Lite, como mostrado na ilustração a seguir.