如何以程式設計方式存取AEM JCR

您可以以程式設計方式修改位於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。 如需詳細資訊,請參閱 將CQ資料儲存在Java內容存放庫中.

注意

若要使用JCR API,請新增 jackrabbit-standalone-2.4.0.jar 檔案至您的Java應用程式的類別路徑。 您可以從Java JCR API網頁取得此JAR檔案,網址為 https://jackrabbit.apache.org/jcr/jcr-api.html.

注意

若要瞭解如何使用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物件,使用它的建構函式並傳遞下列字串值:

  • 使用者名稱;
  • 對應的密碼

傳遞第二個引數時,呼叫字串物件的 toCharArray方法。 下列程式碼會示範如何呼叫 login傳回「 」的方法 javax.jcr.Sessioninstance.

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

建立節點例項

使用 Session要建立的例項 javax.jcr.Node 執行個體。 A 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());

在Adobe CQ存放庫中建立節點

以下Java程式碼範例代表連線至Adobe CQ的Java類別,會建立 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,如下圖所示。

chlimage_1-68

本頁內容