伺服器端自訂 server-side-customization
Java API java-apis
SocialComponent介面 socialcomponent-interface
SocialComponents是POJO,代表AEM Communities功能的資源。 理想情況下,每個SocialComponent都表示特定的resourceType,它具有向客戶端提供資料的公開的GETter,以便準確表示資源。 所有業務邏輯和檢視邏輯都封裝在SocialComponent中,包括網站訪客的工作階段資訊(如有必要)。
該介面定義了表示資源所需的基本GETter集。 重要的是,介面規定了地圖<string object=""> 轉譯Handlebars範本並公開資源的GETJSON端點所需的getAsMap()和String toJSONString()方法。
所有SocialComponent類別都必須實作介面 com.adobe.cq.social.scf.SocialComponent
SocialCollectionComponent介面 socialcollectioncomponent-interface
SocialCollectionComponent介面可擴充SocialComponent介面,以更妥善地呈現其他資源的集合。
所有SocialCollectionComponent類別都必須實作介面com.adobe.cq.social.scf.SocialCollectionComponent
SocialComponentFactory介面 socialcomponentfactory-interface
SocialComponentFactory(factory)會將SocialComponent註冊到框架中。 工廠提供一種方法,讓框架知道哪些SocialComponents可用於指定的resourceType及其優先順序排名*識別多個SocialComponents時。
SocialComponentFactory負責建立所選SocialComponent的例項,以便能夠使用DI實務從工廠插入SocialComponent所需的所有相依性。
SocialComponentFactory是OSGi服務,可存取其他OSGi服務,這些服務可透過建構函式傳遞至SocialComponent。
所有SocialComponentFactory類都必須實作介面 com.adobe.cq.social.scf.SocialComponentFactory
SocialComponentFactory.getPriority()方法的實作應傳回最高值,以便工廠用於getResourceType()傳回的指定resourceType。
SocialComponentFactoryManager介面 socialcomponentfactorymanager-interface
SocialComponentFactoryManager(管理員)管理在框架中註冊的所有SocialComponents,並負責選擇用於指定資源(resourceType)的SocialComponentFactory。 如果沒有為特定資源類型註冊工廠,則經理將返回具有給定資源的最接近超級類型的工廠。
SocialComponentFactoryManager是OSGi服務,可存取其他OSGi服務,這些服務可透過建構函式傳遞至SocialComponent。
通過調用獲得對OSGi服務的句柄 com.adobe.cq.social.scf.SocialComponentFactoryManager
HTTP API -POST要求 http-api-post-requests
PostOperation類 postoperation-class
HTTP APIPOST端點是透過實作 SlingPostOperation
介面(包) org.apache.sling.servlets.post
)。
此 PostOperation
端點實作集 sling.post.operation
值,此值會由操作回應。 所有將a:operation參數設為該值的POST請求將委派給此實施類別。
此 PostOperation
調用 SocialOperation
執行操作所需的操作。
此 PostOperation
從 SocialOperation
並將適當的回應傳回給用戶端。
SocialOperation類 socialoperation-class
每個 SocialOperation
端點擴展AbstractSocialOperation類並覆蓋方法 performOperation().
此方法會執行完成操作所需的所有動作,並傳回 SocialOperationResult
或者扔 OperationException
,在此情況下,會傳回含有訊息的HTTP錯誤狀態(若有),取代一般JSON回應或成功HTTP狀態代碼。
延伸 AbstractSocialOperation
使得 SocialComponents
來傳送JSON回應。
SocialOperationResult類 socialoperationresult-class
此 SocialOperationResult
類別會以 SocialOperation
和由 SocialComponent
、 HTTP狀態代碼和HTTP狀態消息。
此 SocialComponent
代表受操作影響的資源。
對於建立操作, SocialComponent
包含在 SocialOperationResult
代表剛建立的資源,對於更新操作,它代表由操作更改的資源。 否 SocialComponent
會針對刪除操作傳回。
使用的成功HTTP狀態代碼為
- 201:建立操作
- 更新操作200
- 204:刪除操作
OperationException類 operationexception-class
安 OperationExcepton
如果請求無效或發生其他錯誤,例如內部錯誤、錯誤的參數值、不正確的權限等,則在執行操作時可能會擲回。 安 OperationException
由HTTP狀態代碼和錯誤消息組成,這些消息將作為對 PostOperatoin
.
操作服務類 operationservice-class
社交元件架構建議,負責執行操作的業務邏輯不要在 SocialOperation
類別,但改為委派給OSGi服務。 將OSGi服務用於商業邏輯可允許 SocialComponent
,由 SocialOperation
端點,與其他代碼整合,應用不同的業務邏輯。
全部 OperationService
類擴展 AbstractOperationService
,允許可連結至所執行操作的其他擴充功能。 服務中的每個操作由 SocialOperation
類別。 此 OperationExtensions
可通過調用方法在操作執行期間調用類
performBeforeActions()
允許預檢查/預處理和驗證performAfterActions()
允許進一步修改資源或叫用自訂事件、工作流程等
操作擴展類 operationextension-class
OperationExtension
類別是可插入到操作中的自定義代碼片段,允許定制操作以滿足業務需要。 元件的使用者可以動態且逐步地新增功能至元件。 擴充功能/連結模式可讓開發人員專注在擴充功能本身,而無須複製和覆寫整個作業和元件。
程式碼範例 sample-code
范常式式碼可在 Adobe Marketing Cloud GitHub 存放庫。 搜尋以下項目中的其中一個 aem-communities
或 aem-scf
.
最佳做法 best-practices
檢視 編碼准則 區段,了解AEM Communities開發人員的各種編碼准則和最佳實務。
另請參閱 UGC的儲存資源提供程式(SRP) 了解如何存取使用者產生的內容。