服務容器 service-container
位於服務容器中的AEM Forms服務(包括標準服務,如加密服務、長期和短期進程)可以使用各種提供程式(如EJB提供程式)調用。 EJB提供程式允許通過RMI/IIOP調用AEM Forms服務。 Web服務提供程式使用SOAP/HTTP和SOAP/JMS等標準將服務作為Web服務(WSDL生成)公開。
下表說明以程式設計方式叫用AEM Forms服務的不同方式。
AEM Forms支援SOAP/HTTP等網站服務標準。 服務可以作為Web服務公開,WSDL符合W3C定義的Web服務標準。
可從任何Web服務堆棧(包括.NET Framework和Sun™ Web Services SDK)中調用服務。 (請參閱 使用Web服務叫用AEM Forms.)
下圖以視覺化方式呈現以程式設計方式叫用AEM Forms服務的不同方式。
com.adobe.idp.BankAccount
. 然後,您可以建立 com.adobe.idp.BankAccount
例項。服務容器提供下列功能:
-
允許使用不同方法叫用AEM Forms服務。 您可以設定端點來設定服務,以便使用所有方法叫用該服務:遠端、Java API、網站服務及REST。 (請參閱 以寫程式方式管理端點.)
-
將消息轉換為稱為調用請求的標準化格式。 調用請求從客戶端應用程式(或其他服務)發送到位於服務容器中的服務。 調用請求包含諸如要調用的服務的名稱和執行該操作所需的資料值之類的資訊。 許多服務都需要文檔來執行操作。 因此,調用請求通常包含一個文檔,它可以是PDF資料、XDP資料、XML資料等。
-
將調用請求路由到相應的服務(要調用的服務的名稱是調用請求的一部分)。
-
執行任務,如確定調用者是否具有調用指定服務操作的權限。 調用請求必須包含有效的AEM表單用戶名和密碼。
向服務發送調用請求有不同的方法。 此外,您也可透過不同方式將必要的輸入值傳送至服務。 例如,假設您使用Java API來叫用需要PDF檔案的服務。 相應的Java方法包含接受PDF文檔的參數。 在此情況下,參數的資料類型為
com.adobe.idp.Document
. (請參閱 使用Java API將資料傳遞至AEM Forms服務.)如果您使用觀看資料夾叫用服務,則當您將檔案置於已設定的觀看資料夾時,會傳送叫用請求。 如果您使用電子郵件叫用服務,則當電子郵件到達配置的收件箱時,將向服務發送調用請求。
執行操作後,服務容器會傳回呼叫回應。 調用響應包含諸如操作結果之類的資訊。 例如,如果操作修改PDF文檔,則調用響應包含修改的PDF文檔。 如果操作失敗,則調用響應將包含錯誤消息。
可以用發送調用請求的相同方式來檢索調用響應。 也就是說,如果使用Java API傳送叫用請求,則可使用Java API擷取叫用回應。 例如,假設操作修改PDF文檔。 通過獲取調用服務的Java方法的返回值,可以檢索修改的PDF文檔。
當調用長壽命進程時,調用響應包含與調用請求相關聯的標識符值。 使用此識別碼值,您稍後可以檢查程式狀態。 例如,請考慮MortgageLoan長期服務。 使用標識符值,可以檢查以確定該過程是否成功完成。 (請參閱 調用以人為中心的長壽命過程.)
下圖顯示叫用服務的用戶端應用程式(使用Java API)。
當客戶端應用程式調用服務時,會發生三個事件:
- 客戶端應用程式向服務發送調用請求。
- 服務執行調用請求中指定的操作。
- 服務容器將調用響應返回到客戶端應用程式。
另請參閱
使用叫用AEM Forms(AEM表單已淘汰)AEM Forms Remoting