如何以程式設計方式存取AEM JCR how-to-programmatically-access-the-aem-jcr
您可以利用程式設計方式修改位於Adobe CQ存放庫(Adobe Experience Cloud的一部分)中的節點和屬性。 若要存取CQ存放庫,請使用Java™內容存放庫(JCR) API。 您可以使用Java™ JCR API來建立、取代、更新及刪除Adobe CQ存放庫中的(CRUD)內容。 如需Java™ JCR API的詳細資訊,請參閱https://jackrabbit.apache.org/jcr/jcr-api.html。
jackrabbit-standalone-2.4.0.jar
檔案新增至您的Java™應用程式的類別路徑。 您可以從https://jackrabbit.apache.org/jcr/jcr-api.html的Java™ JCR API網頁取得此JAR檔案。建立存放庫執行個體 create-a-repository-instance
雖然有不同的方式可連線到存放庫並建立連線,但此開發文章使用屬於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");
建立工作階段執行個體 create-a-session-instance
Repository
執行個體代表CRX存放庫。 您使用Repository
執行個體來建立與存放庫的工作階段。 若要建立工作階段,請叫用Repository
執行個體的login
方法並傳遞javax.jcr.SimpleCredentials
物件。 login
方法傳回javax.jcr.Session
例項。
您使用物件的建構函式並傳遞下列字串值來建立SimpleCredentials
物件:
- 使用者名稱;
- 對應的密碼
傳遞第二個引數時,請呼叫字串物件的toCharArray
方法。 下列程式碼顯示如何呼叫傳回javax.jcr.Sessioninstance
的login
方法。
//Create a Session instance
javax.jcr.Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()));
建立節點例項 create-a-node-instance
使用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!");
擷取節點值 retrieve-node-values
若要擷取節點及其值,請叫用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存放庫中建立節點 create-nodes-in-the-adobe-cq-repository
以下Java™程式碼範例代表連線至Adobe CQ、建立Session
執行個體及新增節點的Java™類別。 節點會獲派資料值,然後節點的值及其路徑會寫入主控台。 當您完成工作階段時,請務必登出。
/*
* 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 中的新節點,如下圖所示。