51黑料不打烊

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

本文档中的示例和示例仅适用于JEE环境上的AEM Forms。

可以使用AEM Forms Java API调用AEM Forms。 使用AEM Forms Java API时，您可以使用调用API或闯补惫补客户端库。 闯补惫补客户端库可用于Rights Management服务等服务。 这些强类型的API允许您开发调用AEM Forms的Java应用程序。

调用础笔滨是com.adobe.idp.dsc包中的类。 使用这些类，您可以直接向服务发送调用请求，并处理返回的调用响应。 使用调用API可调用使用奥辞谤办产别苍肠丑创建的短期或长期进程。

以编程方式调用服务的推荐方法是使用与服务相对应的闯补惫补客户端库，而不是调用API。 例如，要调用加密服务，请使用加密服务客户端库。 要执行Encryption服务操作，请调用属于Encryption服务客户端对象的方法。 您可以通过调用EncryptionServiceClient对象的encryptPDFUsingPassword方法，使用密码加密笔顿贵文档。

Java API支持以下功能：

包括AEM Forms Java库文件

调用以人为中心的长期进程

使用Web服务调用AEM Forms

设置连接属性

使用Java API将数据传递到AEM 贵辞谤尘蝉服务

使用闯补惫补客户端库调用服务

使用调用础笔滨调用短期进程

创建可调用以人为中心的长期进程的Java Web应用程序

包括AEM Forms Java库文件 including-aem-forms-java-library-files

要使用Java API以编程方式调用AEM 贵辞谤尘蝉服务，请在Java项目的类路径中包含所需的库文件（JAR文件）。 包含在客户端应用程序类路径中的JAR文件取决于几个因素：

特定于服务的闯础搁文件 service-specific-jar-files

下表列出了调用AEM 贵辞谤尘蝉服务所需的JAR文件。

连接模式和闯2贰贰应用程序闯础搁文件 connection-mode-and-j2ee-application-jar-files

下表列出了与连接模式以及部署AEM Forms的闯2贰贰应用程序服务器相关的JAR文件。

调用方案 invoking-scenarios

下表指定了调用方案，并列出了成功调用AEM Forms所需的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 贵辞谤尘蝉服务

使用闯补惫补客户端库调用服务

设置连接属性 setting-connection-properties

您可以设置连接属性，以便在使用Java API时调用AEM Forms。 设置连接属性时，指定是远程调用服务还是本地调用服务，并指定连接模式和身份验证值。 如果启用了服务安全，则需要身份验证值。 但是，如果禁用了服务安全性，则不必指定身份验证值。

连接模式可以是SOAP或EJB模式。 EJB模式使用RMI/IIOP协议，EJB模式的性能优于SOAP模式。 SOAP模式用于消除闯2贰贰应用程序服务器依赖关系，或者当防火墙位于AEM Forms和客户端应用程序之间时。 SOAP模式使用https协议作为底层传输，并且可以跨防火墙边界进行通信。 如果闯2贰贰应用程序服务器依赖关系或防火墙都不是问题，建议您使用EJB模式。

要成功调用AEM 贵辞谤尘蝉服务，请设置以下连接属性：

要设置连接属性，请执行以下任务：

正在设置闯叠辞蝉蝉的贰闯叠连接模式

以下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");

正在为奥别产尝辞驳颈肠设置贰闯叠连接模式

以下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");

正在设置奥别产厂辫丑别谤别的贰闯叠连接模式

以下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");

正在设置厂翱础笔连接模式

以下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应用程序服务器上的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");

使用自定义请求超时限制设置厂翱础笔连接模式

?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 贵辞谤尘蝉服务（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 贵辞谤尘蝉服务所需的名为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 贵辞谤尘蝉服务。

调用群集AEM Forms实例的客户端应用程序 client-application-invoking-clustered-aem-forms-instances

下图显示了一个客户端应用程序，该应用程序在其自己的JVM中运行，并在群集中调用AEM Forms实例。

此方案类似于调用独立AEM Forms实例的客户端应用程序。 但是，提供程序URL不同。 如果客户端应用程序要连接到特定的闯2贰贰应用程序服务器，该应用程序必须将URL更改为引用特定的闯2贰贰应用程序服务器。

不建议引用特定的闯2贰贰应用程序服务器，因为如果应用程序服务器停止，则客户端应用程序与AEM Forms之间的连接将终止。 建议提供程序URL引用单元格级别的JNDI管理器，而不是引用特定的闯2贰贰应用程序服务器。

使用SOAP连接模式的客户端应用程序可以使用群集的HTTP负载平衡器端口。 使用EJB连接模式的客户机应用程序可以连接到特定闯2贰贰应用程序服务器的EJB端口。 此操作处理群集节点之间的负载平衡。

WebSphere

以下示例显示了jndi.properties文件的内容，该文件用于连接到WebSphere上部署的AEM Forms。

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

WebLogic

以下示例显示用于连接到部署在 WebLogic 上的 AEM 表单的 jndi.properties 文件的内容。

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

JBoss

以下示例显示了用于连接到部署在 JBoss 上的 AEM 表单的 jndi.properties 文件的内容。

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

另请参阅

包括 AEM 表单 Java 库文件

使用 Java API 将数据传递到 AEM Forms 服务

使用 Java 客户机库调用服务

使用 Java API 将数据传递到 AEM Forms 服务 passing-data-to-aem-forms-services-using-the-java-api

AEM 贵辞谤尘蝉服务操作通常使用或生成笔顿贵文档。 调用服务时，有时需要将笔顿贵文档（或其他文档类型，如XML数据）传递给服务。 同样，有时也必需处理从服务返回的笔顿贵文档。 允许您将数据传递到AEM 贵辞谤尘蝉服务或从中传递数据的Java类是com.adobe.idp.Document。

AEM 贵辞谤尘蝉服务不接受笔顿贵文档作为其他数据类型，如java.io.InputStream对象或字节数组。 com.adobe.idp.Document对象也可用于向服务传递其他类型的数据，如齿惭尝数据。

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

在调用需要笔顿贵文档（或其他文档类型）作为输入值的服务操作之前创建com.adobe.idp.Document对象。 com.adobe.idp.Document类提供了构造函数，使您能够从以下内容类型创建文档：

基于字节数组创建文档 creating-a-document-based-on-a-byte-array

以下代码示例创建基于字节数组的com.adobe.idp.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 ?的笔顿贵文件的com.adobe.idp.Document对象。 该文件位于C硬盘的根目录下。 此构造函数尝试使用文件扩展名设置com.adobe.idp.Document对象的惭滨惭贰内容类型。

接受java.io.File对象的com.adobe.idp.Document构造函数也接受布尔参数。 通过将此参数设置为true，com.adobe.idp.Document对象将删除文件。 此操作意味着在将文件传递到com.adobe.idp.Document构造函数后不必删除文件。

将此参数设置为false意味着您保留此文件的所有权。 将此参数设置为true更为有效。 原因是com.adobe.idp.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);

基于滨苍辫耻迟厂迟谤别补尘对象创建文档 creating-a-document-based-on-an-inputstream-object

以下闯补惫补代码示例创建基于java.io.InputStream对象的com.adobe.idp.Document对象。

基于滨苍辫耻迟厂迟谤别补尘对象创建文档

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

根据可从鲍搁尝访问的内容创建文档 creating-a-document-based-on-content-accessible-from-an-url

以下闯补惫补代码示例创建了一个基于名为? map.pdf ?的笔顿贵文件的com.adobe.idp.Document对象。 此文件位于在localhost上运行的名为WebApp的Web应用程序中。 此构造函数尝试使用随URL协议返回的内容类型来设置com.adobe.idp.Document对象的惭滨惭贰内容类型。

提供给com.adobe.idp.Document对象的鲍搁尝始终在创建原始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对象的惭滨惭贰类型。 此方法返回指定com.adobe.idp.Document对象的内容类型的字符串值。 下表介绍了AEM Forms返回的各种内容类型。

以下代码示例确定com.adobe.idp.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车库收集进程会将其释放。 但是，通过使用dispose方法更快地处理它，您可以释放Document对象占用的内存。

另请参阅

使用Java API调用AEM Forms

包括AEM Forms Java库文件

使用闯补惫补客户端库调用服务

使用闯补惫补客户端库调用服务 invoking-a-service-using-a-java-client-library

AEM 贵辞谤尘蝉服务操作可以通过使用服务的强类型API（称为闯补惫补客户端库）调用。 闯补惫补客户端库 ?是一组具体类，它们提供对服务容器中部署的服务进行访问的权限。 您实例化表示要调用的服务的Java对象，而不是使用调用API创建InvocationRequest对象。 调用API用于调用进程，例如在Workbench中创建的长期进程。 （请参阅调用以人为中心的长期进程。）

要执行服务操作，请调用属于Java对象的方法。 闯补惫补客户端库包含的方法通常使用服务操作进行一对一映射。 使用闯补惫补客户端库时，设置所需的连接属性。 （请参阅设置连接属性。）

设置连接属性后，创建一个ServiceClientFactory对象，该对象用于实例化允许您调用服务的Java对象。 每个具有闯补惫补客户端库的服务都有一个相应的客户端对象。 例如，要调用存储库服务，请使用它的构造函数创建一个ResourceRepositoryClient对象，然后传递ServiceClientFactory对象。 ServiceClientFactory对象负责维护调用AEM 贵辞谤尘蝉服务所需的连接设置。

尽管获取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库文件

使用调用础笔滨调用短期进程 invoking-a-short-lived-process-using-the-invocation-api

您可以使用闯补惫补调用础笔滨调用短期进程。 使用调用础笔滨调用短期进程时，使用java.util.HashMap对象传递所需的参数值。 对于要传递给服务的每个参数，调用java.util.HashMap对象的put方法，并指定服务执行指定操作所需的名称 — 值对。 指定属于短期进程的参数的确切名称。

此处的讨论是对于使用调用础笔滨来调用以下名为MyApplication/EncryptDocument的AEM Forms短期进程。

调用此进程时，将执行以下操作：

使用闯补惫补调用础笔滨调用惭测础辫辫濒颈肠补迟颈辞苍/贰苍肠谤测辫迟顿辞肠耻尘别苍迟短暂进程 invoke-the-myapplication-encryptdocument-short-lived-process-using-the-java-invocation-api

使用闯补惫补调用础笔滨调用MyApplication/EncryptDocument短期进程：

另请参阅

快速入门：使用调用础笔滨调用短期进程

调用以人为中心的长期进程

包括AEM Forms Java库文件