Show Menu
主題×

資產代理開發

Adobe Experience Manager(AEM)Assets會使用代理來分發特定工作的處理。
Proxy是特定(有時也是個別的)AEM例項,使用proxy工作者做為處理工作和建立結果的處理者。 代理工作器可用於各種任務。 如果是AEM Assets Proxy,則可用來載入資產,以便在AEM Assets中轉譯。 例如, IDS代理工作者使用InDesign Server ,來處理檔案以用於AEM Assets。
當proxy是個別的AEM例項時,這有助於降低AEM製作例項的負載。 依預設,AEM Assets會在相同JVM(透過Proxy外部化)中執行資產處理工作,以減少AEM製作例項的負載。

代理(HTTP存取)

Proxy可透過HTTP Servlet取得,當它設定為接受下列位置的處理工作時: /libs/dam/cloud/proxy . 此servlet會從已張貼的參數建立sling工作。 然後,這會新增至代理工作佇列,並連線至適當的代理工作器。

支援的作業

  • job
    需求 : 參數必 jobevent 須設為序列化值映射。 這用於為作業處 Event 理器建立。
    結果 : 新增工作。 如果成功,則會傳回唯一的工作ID。
curl -u admin:admin -F":operation=job" -F"someproperty=xxxxxxxxxxxx"
    -F"jobevent=serialized value map" http://localhost:4502/libs/dam/cloud/proxy

  • result
    需求 : 必須 jobid 設定參數。
    結果 : 傳回由作業處理者建立之結果節點的JSON表示法。
curl -u admin:admin -F":operation=result" -F"jobid=xxxxxxxxxxxx"
    http://localhost:4502   /libs/dam/cloud/proxy

  • resource
    需求 : 必須設定參數jobid。
    結果 : 返回與給定作業關聯的資源。
curl -u admin:admin -F":operation=resource" -F"jobid=xxxxxxxxxxxx"
    -F"resourcePath=something.pdf" http://localhost:4502/libs/dam/cloud/proxy

  • remove
    需求 : 必須設定參數jobid。
    結果 : 如果找到作業,則刪除作業。
curl -u admin:admin -F":operation=remove" -F"jobid=xxxxxxxxxxxx"
    http://localhost:4502/libs/dam/cloud/proxy

Proxy Worker

代理工作者是負責處理作業和建立結果的處理者。 工作者駐留在proxy例項上,且必須實作 sling JobProcessor ,才能被辨識為proxy工作者。
工作者必須實作 sling JobProcessor ,才能被辨識為代理工作者。

用戶端API

JobService 可作為OSGi服務使用,該服務提供建立作業、刪除作業和從這些作業中獲取結果的方法。 此服務的預設實現( JobServiceImpl )使用HTTP客戶端與遠程代理Servlet通信。
以下是API使用的範例:
@Reference
 JobService proxyJobService;

 // to create a new job
 final Hashtable props = new Hashtable();
 props.put("someproperty", "some value");
 props.put(JobUtil.PROPERTY_JOB_TOPIC, "myworker/job"); // this is an identifier of the worker
 final String jobId = proxyJobService.addJob(props, new Asset[]{asset});

 // to check status (returns JobService.STATUS_FINISHED or JobService.STATUS_INPROGRESS)
 int status = proxyJobService.getStatus(jobId)

 // to get the result
 final String jsonString = proxyJobService.getResult(jobId);

 // to remove job and cleanup
 proxyJobService.removeJob(jobId);

雲端服務設定

Proxy API的參考檔案可在下方取得 com.day.cq.dam.api.proxy
Proxy和Proxy工作器組態都可透過雲端服務組態取得,您可從AEM Assets Tools Console或下方存取 /etc/cloudservices/proxy 。 每個代理工作器都需要在下添加一個節點, /etc/cloudservices/proxy 以瞭解工作器特定的配置詳細資訊( /etc/cloudservices/proxy/workername 例如)。
以下是API使用的範例:
@Reference(policy = ReferencePolicy.STATIC)
 ProxyConfig proxyConfig;
 
 // to get proxy config
 Configuration cloudConfig = proxyConfig.getConfiguration();
 final String value = cloudConfig.get("someProperty", "defaultValue");

 // to get worker config
 Configuration cloudConfig = proxyConfig.getConfiguration("workername");
 final String value = cloudConfig.get("someProperty", "defaultValue");

開發自訂的Proxy Worker

IDS 代理工作者 (Proxy Worker)是AEM Assets代理工作者的範例,此代理工作者已提供現成可用的功能,以外包Indesign資產的處理。
您也可以開發和設定您自己的AEM Assets代理工作者,以建立專業工作者來派送和外包您的AEM Assets處理工作。
要設定您自己的自定義代理工作器,您必須:
  • 設定和實作(使用Sling事件):
    • 自訂工作主題
    • 自訂工作事件處理常式
  • 然後,使用JobService API可:
    • 將您的自訂工作分派給代理
    • 管理您的工作
  • 如果您想從工作流程使用Proxy,則必須使用WorkflowExternalProcess API和JobService API實作自訂外部步驟。
下圖和步驟詳細說明如何繼續:
在以下步驟中,Indesign等效項指示為參考示例。
  1. A Sling job is used, so you need to define a job topic for your use case.
    例如,請參見 IDSJob.IDS_EXTENDSCRIPT_JOB 有關IDS代理工作器的資訊。
  2. 外部步驟用來觸發事件,然後等待完成; 這是透過輪詢id來完成的。 您必須自行制定實施新功能的步驟。
    實作 WorkflowExternalProcess ,然後使用JobService API和您的工作主題來準備工作事件並將其分派至JobService(OSGi服務)。
    例如,請參見 INDDMediaExtractProcess .java for the IDS proxy worker。
  3. 實作主題的工作處理常式。 此處理常式需要開發,以便執行您的特定動作,並視為工作者實作。
    例如,請參見 IDSJobProcessor.java 有關IDS代理工作器的資訊。
  4. 運用在 ProxyUtil.java 大壩共用中。 這可讓您使用dam代理將工作分派給員工。
AEM Assets proxy架構不提供現成可用的池機制。
InDesign整合可讓您存取InDesign Servers(IDSPool)池。 此集區是Indesign整合專用的,不屬於AEM Assets代理架構的一部分。
結果同步:
使用相同proxy的n個例項時,處理結果會保留在proxy中。 是用戶端(AEM作者)的工作,會使用與建立工作時提供給用戶端的相同唯一工作ID來請求結果。 Proxy只會完成工作,並讓結果隨時可供要求。