使用Java API叫用AEM Forms invoking-aem-forms-using-the-javaapi

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

AEM Forms可透過使用AEM Forms Java API來叫用。 使用AEM Forms Java API時，您可以使用叫用API或Java使用者端資料庫。 Java使用者端程式庫可用於Rights Management服務之類的服務。 這些強型別API可讓您開發叫用AEM Forms的Java應用程式。

引動API是com.adobe.idp.dsc封裝中的類別。 使用這些類別，您可以直接傳送呼叫要求給服務，並處理傳回的呼叫回應。 使用叫用API來叫用使用Workbench建立的短期或長期程式。

以程式設計方式叫用服務的建議方法是使用與服務相對應的Java使用者端程式庫，而不是叫用API。 例如，若要叫用加密服務，請使用加密服務使用者端程式庫。 若要執行「加密」服務作業，請叫用屬於「加密」服務使用者端物件的方法。 您可以叫用EncryptionServiceClient物件的encryptPDFUsingPassword方法，以密碼加密PDF檔案。

Java API支援下列功能：

包含AEM Forms Java程式庫檔案

叫用以人為中心的長期流程

使用網站服務叫用AEM Forms

設定連線屬性

使用Java API傳遞資料至AEM Forms服務

使用Java使用者端程式庫叫用服務

使用叫用API叫用短期程式

建立可叫用以人為中心的長期流程的Java網頁應用程式

包含AEM Forms Java程式庫檔案 including-aem-forms-java-library-files

若要使用Java API以程式設計方式叫用AEM Forms服務，請在Java專案的類別路徑中加入必要的程式庫檔案（JAR檔案）。 包含在使用者端應用程式類別路徑中的JAR檔案取決於幾個因素：

服務特定的JAR檔案 service-specific-jar-files

下表列出呼叫AEM Forms服務所需的JAR檔案。

連線模式和J2EE應用程式JAR檔案 connection-mode-and-j2ee-application-jar-files

下表列出的JAR檔案，視連線模式以及部署AEM Forms的J2EE應用程式伺服器而定。

叫用案例 invoking-scenarios

下表指定叫用案例，並列出成功叫用AEM Forms所需的JAR檔案。

升級JAR檔案 upgrading-jar-files

如果您從LiveCycle升級為AEM Forms，建議您在Java專案的類別路徑中包含AEM Forms JAR檔案。 例如，如果您使用Rights Management服務等服務，如果您未在類別路徑中包含AEM Forms JAR檔案，則會遇到相容性問題。

假設您要升級至AEM Forms。 若要使用叫用Rights Management服務的Java應用程式，請包含下列JAR檔案的AEM Forms版本：

另請參閱

使用Java API叫用AEM Forms

設定連線屬性

使用Java API傳遞資料至AEM Forms服務

使用Java使用者端程式庫叫用服務

設定連線屬性 setting-connection-properties

使用Java API時，您可以設定連線屬性來叫用AEM Forms。 設定連線屬性時，請指定從遠端還是從本機叫用服務，同時指定連線模式和驗證值。 如果啟用了服務安全性，則需要驗證值。 但是，如果停用服務安全性，則不需要指定驗證值。

連線模式可以是SOAP或EJB模式。 EJB模式使用RMI/IIOP通訊協定，而EJB模式的效能比SOAP模式的效能好。 SOAP模式用於消除J2EE應用程式伺服器相依性，或當防火牆位於AEM Forms和使用者端應用程式之間時。 SOAP模式使用https通訊協定做為基礎傳輸，而且可以跨防火牆邊界通訊。 如果J2EE應用程式伺服器相依性或防火牆都不是問題，建議您使用EJB模式。

若要成功叫用AEM Forms服務，請設定下列連線屬性：

若要設定連線內容，請執行下列工作：

正在設定JBoss的EJB連線模式

以下Java程式碼範例會設定連線屬性，以叫用部署在JBoss上的AEM Forms，並使用EJB連線模式。

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "https://<hostname>:8080");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DOCUMENT_HTTP_ENDPOINT,"https://<hostname>:8080");

正在設定WebLogic的EJB連線模式

下列Java程式碼範例會設定連線屬性，以叫用建置在WebLogic上的AEM Forms，並使用EJB連線模式。

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "t3://localhost:7001");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "WebLogic");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");

正在設定WebSphere的EJB連線模式

下列Java程式碼範例會設定連線屬性，以叫用建置在WebSphere上的AEM Forms，並使用EJB連線模式。

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "iiop://localhost:2809");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "WebSphere");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");

正在設定SOAP連線模式

以下Java程式碼範例會在SOAP模式下設定連線屬性，以叫用部署在JBoss上的AEM Forms。

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://localhost:8080");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");

在停用服務安全性時設定連線內容

以下Java程式碼範例會設定呼叫JBoss Application Server上部署的AEM Forms以及停用服務安全性時所需的連線屬性。

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://localhost:1099");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");

使用自訂要求逾時限制設定SOAP連線模式

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://localhost:8080");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT, "1800000"); // Request timeout limit 30 Minutes

使用內容物件來叫用AEM Forms

您可以使用com.adobe.idp.Context物件來叫用具有已驗證使用者的AEM Forms服務（com.adobe.idp.Context物件代表已驗證的使用者）。 使用com.adobe.idp.Context物件時，您不需要設定DSC_CREDENTIAL_USERNAME或DSC_CREDENTIAL_PASSWORD屬性。 您可以使用AuthenticationManagerServiceClient物件的authenticate方法在驗證使用者時取得com.adobe.idp.Context物件。

authenticate方法傳回包含驗證結果的AuthResult物件。 您可以透過叫用它的建構函式來建立com.adobe.idp.Context物件。 接著叫用com.adobe.idp.Context物件的initPrincipal方法並傳遞AuthResult物件，如下列程式碼所示：

 Context myCtx = new Context();
 myCtx.initPrincipal(authResult);

您可以叫用ServiceClientFactory物件的setContext方法並傳遞com.adobe.idp.Context物件，而不設定DSC_CREDENTIAL_USERNAME或DSC_CREDENTIAL_PASSWORD屬性。 使用AEM表單使用者叫用服務時，請確定他們具有叫用AEM Forms服務所需的名為Services User的角色。

下列程式碼範例說明如何在用來建立EncryptionServiceClient物件的連線設定中使用com.adobe.idp.Context物件。

 //Authenticate a user and use the Context object within connection settings
 // Authenticate the user
 String username = "wblue";
 String password = "password";
 AuthResult authResult = authClient.authenticate(username, password.getBytes());

 //Set a Content object that represents the authenticated user
 //Use the Context object to invoke the Encryption service
 Context myCtx = new Context();
 myCtx.initPrincipal(authResult);

 //Set connection settings
 Properties connectionProps = new Properties();
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://<server>:1099");
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL, ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE);
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DOCUMENT_HTTP_ENDPOINT,"jnp://<server>:1099");


 //Create a ServiceClientFactory object
 ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps);
 myFactory.setContext(myCtx);

 //Create an EncryptionServiceClient object
 EncryptionServiceClient encryptClient  = new EncryptionServiceClient(myFactory);

叫用案例 invoking_scenarios-1

本節將討論下列叫用案例：

叫用獨立AEM Forms執行個體的使用者端應用程式 client-application-invoking-a-stand-alone-aem-forms-instance

下圖顯示在其自己JVM中執行並叫用獨立AEM Forms執行個體的使用者端應用程式。

在此案例中，使用者端應用程式在其自己的JVM中執行，並叫用AEM Forms服務。

叫用叢集AEM Forms執行個體的使用者端應用程式 client-application-invoking-clustered-aem-forms-instances

下圖顯示在其自己的JVM中執行並叫用叢集中的AEM Forms執行個體的使用者端應用程式。

此案例類似於叫用獨立AEM Forms例項的使用者端應用程式。 不過，提供者URL不同。 如果從屬端應用程式想要連線到特定的J2EE應用程式伺服器，應用程式必須將URL變更為參照特定的J2EE應用程式伺服器。

不建議參考特定的J2EE應用程式伺服器，因為如果應用程式伺服器停止，使用者端應用程式和AEM Forms之間的連線就會終止。 建議提供者URL參考儲存格層級JNDI管理員，而非特定的J2EE應用程式伺服器。

使用SOAP連線模式的使用者端應用程式可以使用叢集的HTTP負載平衡器連線埠。 使用EJB連線模式的從屬端應用程式可以連線到特定J2EE應用程式伺服器的EJB連線埠。 此動作會處理叢集節點之間的負載平衡。

WebSphere

下列範例顯示用來連線至WebSphere上所部署AEM Forms的jndi.properties檔案內容。

 java.naming.factory.initial=com.ibm.websphere.naming.
 WsnInitialContextFactory
 java.naming.provider.url=corbaloc::appserver1:9810,:appserver2:9810

WebLogic

下面的示例演示用於連接到部署在 WebLogic 上的AEM Forms的 jndi.properties 文件的內容。

 java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
 java.naming.provider.url=t3://appserver1:8001, appserver2:8001

JBoss

以下示例顯示了用於連接到部署在 JBoss 上的AEM Forms的 jndi.properties 文件的內容。

 java.naming.factory.initial= org.jnp.interfaces.NamingContextFactory
 java.naming.provider.url= jnp://appserver1:1099, appserver2:1099,
 appserver3:1099

另請參閱

包括 AEM Forms Java 資料庫 檔案

使用 Java API 將數據傳遞至 AEM Forms 服務

使用 Java 客戶機資料庫叫用服務

使用 Java API 將數據傳遞至 AEM Forms 服務 passing-data-to-aem-forms-services-using-the-java-api

AEM Forms服務作業通常會消耗或產生PDF檔案。 當您叫用服務時，有時必須將PDF檔案（或其他檔案型別，例如XML資料）傳遞給服務。 同樣地，有時候，處理從服務傳回的PDF檔案也是必要的。 可讓您在AEM Forms服務之間傳遞資料的Java類別是com.adobe.idp.Document。

AEM Forms服務不接受PDF檔案做為其他資料型別，例如java.io.InputStream物件或位元組陣列。 com.adobe.idp.Document物件也可用來將其他型別的資料（例如XML資料）傳遞至服務。

com.adobe.idp.Document物件是Java可序列化型別，因此可透過RMI呼叫傳遞。 接收端可以並置（相同主機、相同類別載入器）、本機（相同主機、不同類別載入器）或遠端（不同主機）。 檔案內容的傳遞已針對每個案例最佳化。 例如，如果傳送者與接收者位在相同主機上，則內容會透過本機檔案系統傳遞。 （在某些情況下，檔案可以在記憶體中傳遞。）

根據com.adobe.idp.Document物件大小，資料會在com.adobe.idp.Document物件中攜帶或儲存在伺服器的檔案系統中。 com.adobe.idp.Document物件所佔用的任何暫存資源會在com.adobe.idp.Document處置時自動移除。 （請參閱處置檔案物件。）

有時您必須先知道com.adobe.idp.Document物件的內容型別，才能將其傳遞給服務。 例如，如果作業需要特定內容型別（例如application/pdf），建議您決定內容型別。 （請參閱決定檔案的內容型別。）

com.adobe.idp.Document物件會嘗試使用提供的資料來判斷內容型別。 如果無法從提供的資料中擷取內容型別（例如，當資料以位元組陣列提供時），請設定內容型別。 若要設定內容型別，請叫用com.adobe.idp.Document物件的setContentType方法。 （請參閱決定檔案的內容型別）

如果附屬檔案位於相同的檔案系統上，建立com.adobe.idp.Document物件會更快。 如果附屬檔案位於遠端檔案系統上，則必須進行複製操作，這會影響效能。

應用程式可包含com.adobe.idp.Document和org.w3c.dom.Document資料型別。 不過，請確定您已完全符合org.w3c.dom.Document資料型別的資格。 如需有關將org.w3c.dom.Document物件轉換為com.adobe.idp.Document物件的資訊，請參閱快速入門（EJB模式）：使用Java API預先填入Forms的可流程配置。

        // Set up the chunk size to prevent a potential memory leak
        int buffSize = 2048;

        // Determine the total number of bytes to read
        int docLength = (int) inDoc.length();
        byte [] byteDoc = new byte[docLength];

        // Set up the reading position
        int pos = 0;

        // Loop through the document information, 2048 bytes at a time
        while (docLength > 0) {
      // Read the next chunk of information
            int toRead = Math.min(buffSize, docLength);
            int bytesRead = inDoc.read(pos, byteDoc, pos, toRead);

            // Handle the exception in case data retrieval failed
            if (bytesRead == -1) {

                inDoc.doneReading();
                inDoc.dispose();
                throw new RuntimeException("Data retrieval failed!");

            }

             // Update the reading position and number of bytes remaining
             pos += bytesRead;
             docLength -= bytesRead;

        }

        // The document information has been successfully read
        inDoc.doneReading();
        inDoc.dispose();

另請參閱

使用Java API叫用AEM Forms

設定連線屬性

建立檔案 creating-documents

啟動需要PDF檔案（或其他檔案型別）作為輸入值的服務作業之前，請先建立com.adobe.idp.Document物件。 com.adobe.idp.Document類別提供的建構函式可讓您從下列內容型別建立檔案：

根據位元組陣列建立檔案 creating-a-document-based-on-a-byte-array

下列程式碼範例會建立以位元組陣列為基礎的com.adobe.idp.Document物件。

建立以位元組陣列為基礎的Document物件

 Document myPDFDocument = new Document(myByteArray);

根據其他檔案建立檔案 creating-a-document-based-on-another-document

下列程式碼範例會建立以其他com.adobe.idp.Document物件為基礎的com.adobe.idp.Document物件。

建立以其他檔案為基礎的檔案物件

 //Create a Document object based on a byte array
 InputStream is = new FileInputStream("C:\\Map.pdf");
 int len = is.available();
 byte [] myByteArray = new byte[len];
 int i = 0;
 while (i < len) {
       i += is.read(myByteArray, i, len);
 }
 Document myPDFDocument = new Document(myByteArray);

 //Create another Document object
 Document anotherDocument = new Document(myPDFDocument);

根據檔案建立檔案 creating-a-document-based-on-a-file

下列程式碼範例會建立以名為​ map.pdf ​的PDF檔案為基礎的com.adobe.idp.Document物件。 此檔案位於C硬碟的根目錄。 此建構函式會嘗試使用副檔名來設定com.adobe.idp.Document物件的MIME內容型別。

接受java.io.File物件的com.adobe.idp.Document建構函式也接受布林引數。 透過將此引數設定為true，com.adobe.idp.Document物件會刪除檔案。 此動作表示您將檔案傳遞至com.adobe.idp.Document建構函式後，不必移除檔案。

將此引數設定為false表示您保留此檔案的所有權。 將此引數設定為true會更有效率。 原因在於com.adobe.idp.Document物件可以直接將檔案移至本機Managed區域，而非複製檔案（速度較慢）。

建立以PDF檔案為基礎的Document物件

 //Create a Document object based on the map.pdf source file
 File mySourceMap = new File("C:\\map.pdf");
 Document myPDFDocument = new Document(mySourceMap,true);

根據InputStream物件建立檔案 creating-a-document-based-on-an-inputstream-object

下列Java程式碼範例會建立以java.io.InputStream物件為基礎的com.adobe.idp.Document物件。

根據InputStream物件建立檔案

 //Create a Document object based on an InputStream object
 InputStream is = new FileInputStream("C:\\Map.pdf");
 Document myPDFDocument = new Document(is);

根據可從URL存取的內容建立檔案 creating-a-document-based-on-content-accessible-from-an-url

以下Java程式碼範例會根據名為​ map.pdf ​的PDF檔案來建立com.adobe.idp.Document物件。 此檔案位於名為WebApp的Web應用程式中，該應用程式正在localhost上執行。 此建構函式會嘗試使用URL通訊協定傳回的內容型別來設定com.adobe.idp.Document物件的MIME內容型別。

提供給com.adobe.idp.Document物件的URL一律會在建立原始com.adobe.idp.Document物件的一側讀取，如以下範例所示：

     Document doc = new Document(new java.net.URL("file:c:/temp/input.pdf"));

c：/temp/input.pdf 文件必須位於用戶端電腦上（而不是伺服器計算機上）。 用戶端電腦是讀取URL和 com.adobe.idp.Document 創建物件的位置。

根據可從URL存取內容建立文件

 //Create a Document object based on a java.net.URL object
 URL myURL = new URL("http", "localhost", 8080,"/WebApp/map.pdf");

 //Create another Document object
 Document myPDFDocument = new Document(myURL);

另請參閱

使用Java API叫用AEM Forms

設定連線屬性

處理傳回的檔案 handling-returned-documents

返回 PDF 檔（或其他資料類型，如 XML 資料）作為輸出值的服務操作傳回物件 com.adobe.idp.Document 。 收到 com.adobe.idp.Document 物件后，可以將其轉換為以下格式：

下列程式碼行會將com.adobe.idp.Document物件轉換為java.io.InputStream物件。 假設myPDFDocument代表com.adobe.idp.Document物件：

     java.io.InputStream resultStream = myDocument.getInputStream();

同樣地，您可以執行下列工作，將com.adobe.idp.Document的內容複製到本機檔案：

下列程式碼範例將com.adobe.idp.Document物件的內容複製到名為​ AnotherMap.pdf ​的檔案。

正在複製檔案物件的內容至檔案

 File outFile = new File("C:\\AnotherMap.pdf");
 myDocument.copyToFile (outFile);

另請參閱

使用Java API叫用AEM Forms

設定連線屬性

決定檔案的內容型別 determining-the-content-type-of-a-document

呼叫com.adobe.idp.Document物件的getContentType方法，判斷com.adobe.idp.Document物件的MIME型別。 此方法會傳回字串值，指定com.adobe.idp.Document物件的內容型別。 下表說明AEM Forms傳回的不同內容型別。

下列程式碼範例決定com.adobe.idp.Document物件的內容型別。

正在決定Document物件的內容型別

 //Determine the content type of the Document object
 String ct = myDocument.getContentType();
 System.out.println("The content type of the Document object is " +ct);

另請參閱

使用Java API叫用AEM Forms

設定連線屬性

處置檔案物件 disposing-document-objects

當您不再需要Document物件時，建議您叫用其dispose方法來處置它。 每個Document物件會佔用一個檔案描述元，以及應用程式主機平台上最多75 MB的RAM空間。 如果未處置Document物件，則Java Garage收集程式會將其處置。 不過，使用dispose方法儘快處置它，您就可以釋放Document物件所佔用的記憶體。

另請參閱

使用Java API叫用AEM Forms

包含AEM Forms Java程式庫檔案

使用Java使用者端程式庫叫用服務

使用Java使用者端程式庫叫用服務 invoking-a-service-using-a-java-client-library

AEM Forms服務作業可使用服務的強型別API （稱為Java使用者端程式庫）來叫用。 Java使用者端程式庫 ​是一組提供存取服務容器中部署之服務的具體類別。 您將Java物件例項化，該物件代表要叫用的服務，而不是使用叫用API建立InvocationRequest物件。 「叫用API」可用來叫用在Workbench中建立的程式，例如長期程式。 （請參閱叫用以人為中心的長期流程。）

若要執行服務作業，請叫用屬於Java物件的方法。 Java使用者端程式庫所包含的方法，通常會將服務操作對應到一。 使用Java使用者端程式庫時，請設定必要的連線屬性。 （請參閱設定連線屬性。）

在您設定連線屬性之後，請建立ServiceClientFactory物件，用來具現化Java物件，讓您叫用服務。 每個具有Java使用者端程式庫的服務都有對應的使用者端物件。 例如，若要叫用存放庫服務，請使用它的建構函式並傳遞ServiceClientFactory物件來建立ResourceRepositoryClient物件。 ServiceClientFactory物件負責維護呼叫AEM Forms服務所需的連線設定。

雖然取得ServiceClientFactory通常很快，但在第一次使用工廠時會產生一些額外負荷。 此物件已針對重複使用而最佳化，因此，當您建立多個Java使用者端物件時，請儘可能使用相同的ServiceClientFactory物件。 也就是說，請勿為您建立的每個使用者端程式庫物件建立個別的ServiceClientFactory物件。

有一個使用者管理員設定可控制影響ServiceClientFactory物件的com.adobe.idp.Context物件內SAML宣告的存留期。 此設定會控制整個AEM Forms的所有驗證內容存留期，包括使用Java API執行的所有叫用。 根據預設，可以使用ServiceCleintFactory物件的時段為兩個小時。

您可以使用 Java 客戶機資料庫並執行以下步驟來呼叫儲存庫服務：

另請參閱

快速入門（EJB模式）：使用Java API寫入資源

使用Java API叫用AEM Forms

包含AEM Forms Java程式庫檔案

使用叫用API叫用短期程式 invoking-a-short-lived-process-using-the-invocation-api

您可以使用Java叫用API來叫用短期流程。 當您使用叫用API叫用短期處理程式時，您會使用java.util.HashMap物件傳遞必要的引數值。 對於要傳遞給服務的每個引數，請叫用java.util.HashMap物件的put方法，並指定服務執行指定作業所需的名稱 — 值組。 指定屬於短期處理序之引數的確切名稱。

此處的討論內容是關於使用引動API來叫用下列名為MyApplication/EncryptDocument的AEM Forms短期處理序。

叫用此程式時，會執行下列動作：

使用Java叫用API叫用MyApplication/EncryptDocument短期程式 invoke-the-myapplication-encryptdocument-short-lived-process-using-the-java-invocation-api

使用Java叫用API叫用MyApplication/EncryptDocument短期處理序：

另請參閱

快速入門：使用叫用API叫用短期流程

叫用以人為中心的長期流程

包含AEM Forms Java程式庫檔案