您可以以编程方式修改位于Adobe CQ存储库(属于Adobe Marketing Cloud的一部分)中的节点和属性。 要访问CQ存储库,请使用Java内容存储库(JCR)API。 您可以使用Java JCR API对位于Adobe CQ存储库内的内容执行创建、替换、更新和删除(CRUD)操作。 有关Java JCR API的更多信息,请参阅https://jackrabbit.apache.org/jcr/jcr-api.html。
本开发文章从外部Java应用程序修改Adobe CQ JCR。 相反,您可以使用JCR API从OSGi包中修改JCR。 有关详细信息,请参阅在Java内容存储库中保留CQ数据。
要使用JCR API,请将jackrabbit-standalone-2.4.0.jar
文件添加到Java应用程序的类路径中。 您可以从Java JCR API网页的https://jackrabbit.apache.org/jcr/jcr-api.html获取此JAR文件。
要了解如何使用JCR查询API查询Adobe CQ JCR,请参阅使用JCR API查询Adobe Experience Manager数据。
尽管有不同的方法连接到存储库并建立连接,但本开发文章使用属于org.apache.jackrabbit.commons.JcrUtils
类的静态方法。 方法的名称为getRepository
。 此方法采用一个表示Adobe CQ服务器URL的字符串参数。 例如http://localhost:4503/crx/server
。
getRepository
方法返回一个Repository
实例,如以下代码示例中所示。
//Create a connection to the AEM JCR repository running on local host
Repository repository = JcrUtils.getRepository("http://localhost:4503/crx/server");
Repository
实例表示CRX存储库。 使用Repository
实例与存储库建立会话。 要创建会话,请调用Repository
实例的login
方法并传递javax.jcr.SimpleCredentials
对象。 login
方法返回一个javax.jcr.Session
实例。
使用SimpleCredentials
对象的构造函数并传递以下字符串值来创建对象:
传递第二个参数时,调用String对象的toCharArray
方法。 以下代码显示如何调用返回javax.jcr.Sessioninstance
的login
方法。
//Create a Session instance
javax.jcr.Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()));
使用Session
实例创建javax.jcr.Node
实例。 Node
实例允许您执行节点操作。 例如,您可以创建新节点。 要创建表示根节点的节点,请调用Session
实例的getRootNode
方法,如下面的代码行所示。
//Create a Node
Node root = session.getRootNode();
创建Node
实例后,可以执行诸如创建另一个节点和向其添加值之类的任务。 例如,以下代码会创建两个节点,并向第二个节点添加一个值。
// Store content
Node day = adobe.addNode("day");
day.setProperty("message", "Adobe CQ is part of the Adobe Digital Marketing Suite!");
要检索节点及其值,请调用Node
实例的getNode
方法,并将表示该节点完全限定路径的字符串值传递到该节点。 请考虑在上一个代码示例中创建的节点结构。 要检索日节点,请指定adobe/day,如以下代码所示:
// Retrieve content
Node node = root.getNode("adobe/day");
System.out.println(node.getPath());
System.out.println(node.getProperty("message").getString());
以下Java代码示例表示一个Java类,该类连接到Adobe CQ,创建Session
实例并添加新节点。 节点会被分配一个数据值,然后节点的值及其路径会写出到控制台。 完成会话后,请务必注销。
/*
* 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();
}
}
}
运行完整代码示例并创建节点后,可以在CRXDE Lite中查看新节点,如下图所示。