优化Forms服务的性能 optimizing-the-performance-of-theforms-service
本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
优化Forms服务的性能 optimizing-the-performance-of-the-forms-service
渲染表单时，您可以设置运行时选项以优化Forms服务的性能。 要提高Forms服务的性能，您可以执行的另一项任务是，将XDP文件存储在存储库中。 但是，本节并未介绍如何执行此任务。 （请参阅使用Java客户端库调用服务。）
步骤摘要 summary-of-steps
要优化渲染表单时Forms服务的性能，请执行以下任务：
- 包括项目文件。
- 创建Forms客户端API对象。
- 设置性能运行时选项。
- 呈现表单。
- 将表单数据流写入客户端Web浏览器。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序，请包含必要的JAR文件。 如果使用Web服务，请确保包含代理文件。
创建Forms客户端API对象
您必须先创建Forms服务客户端，然后才能以编程方式执行Forms服务客户端API操作。 如果您使用的是Java API，请创建一个FormsServiceClient对象。 如果您使用的是Forms Web服务API，请创建一个FormsService对象。
设置性能运行时选项
可设置以下性能运行时选项以提高Forms服务的性能：
- 表单缓存：您可以在服务器缓存中缓存呈现为PDF的表单。 每个表单在首次生成后都会缓存。 在后续渲染中，如果缓存的表单比表单设计的时间戳新，则从缓存中检索表单。 通过缓存表单，您可以提高Forms服务的性能，因为它不必从存储库检索表单设计。
- 表单指南（已弃用）的呈现时间可能比其他转换类型长。 建议您缓存表单指南（已弃用）以提高性能。
- 独立选项：如果您不需要Forms服务执行服务器端计算，则可以将“独立”选项设置为
true，这将导致表单在没有状态信息的情况下呈现。 如果您希望向最终用户呈现交互式表单，然后最终用户在表单中输入信息并将表单提交回Forms服务，则必须提供状态信息。 然后，Forms服务执行计算操作，并将表单呈现回用户，结果显示在表单中。 如果将没有状态信息的表单提交回Forms服务，则只有XML数据可用，并且不执行服务器端计算。 - 线性化PDF：已组织一个线性化PDF文件，以便在网络环境中实现高效的增量访问。 PDF文件在所有方面都是有效的PDF，并与所有现有查看器和其他PDF应用程序兼容。 也就是说，可以在仍然下载线性PDF时查看该量度。
- 在客户端上呈现PDF表单时，此选项无法提高性能。
- GuideRSL选项：启用使用运行时共享库生成表单指南（已弃用）。 这意味着第一个请求将下载较小的SWF文件，以及存储在浏览器缓存中的较大共享库。 有关更多信息，请参阅Flex文档中的RSL 。
- 您还可以在客户端渲染表单，以提高Forms服务的性能。 (请参阅在客户端渲染Forms。)
渲染表单
要在设置性能选项后渲染表单，请使用与渲染没有性能选项的表单相同的应用程序逻辑。
将表单数据流写入客户端Web浏览器
Forms服务呈现表单后，会返回您必须写入客户端Web浏览器的表单数据流。 在写入客户端Web浏览器时，该表单对用户可见。
另请参阅
使用Java API优化性能 optimize-the-performance-using-the-java-api
使用Forms API (Java)呈现具有优化性能的表单：
-
包含项目文件
在Java项目的类路径中包含客户端JAR文件，例如adobe-forms-client.jar。
-
创建Forms客户端API对象
- 创建包含连接属性的
ServiceClientFactory对象。 - 使用构造函数创建
FormsServiceClient对象并传递ServiceClientFactory对象。
- 创建包含连接属性的
-
设置性能运行时选项
- 使用构造函数创建
PDFFormRenderSpec对象。 - 通过调用
PDFFormRenderSpec对象的setCacheEnabled方法并传递true来设置表单缓存选项。 - 通过调用
PDFFormRenderSpec对象的setLinearizedPDF方法并传递true.来设置线性化选项
- 使用构造函数创建
-
渲染表单
调用
FormsServiceClient对象的renderPDFForm方法并传递以下值：- 一个字符串值，它指定窗体设计名称，包括文件扩展名。
- 包含要与表单合并的数据的
com.adobe.idp.Document对象。 如果不想合并数据，请传递一个空的com.adobe.idp.Document对象。 - 用于存储运行时选项以提高性能的
PDFFormRenderSpec对象。 - 包含Forms服务所需URI值的
URLSpec对象。 - 存储文件附件的
java.util.HashMap对象。 这是一个可选参数，如果您不想将文件附加到表单，则可以指定null。
renderPDFForm方法返回的FormsResult对象包含必须写入客户端Web浏览器的表单数据流。 -
将表单数据流写入客户端Web浏览器
- 创建用于将表单数据流发送到客户端Web浏览器的
javax.servlet.ServletOutputStream对象。 - 通过调用
FormsResult对象的getOutputContent方法创建com.adobe.idp.Document对象。 - 通过调用
com.adobe.idp.Document对象的getInputStream方法创建java.io.InputStream对象。 - 通过调用
InputStream对象的read方法并将字节数组作为参数传递，创建字节数组并使用表单数据流填充该数组。 - 调用
javax.servlet.ServletOutputStream对象的write方法将表单数据流发送到客户端Web浏览器。 将字节数组传递给write方法。
- 创建用于将表单数据流发送到客户端Web浏览器的
另请参阅
使用Web服务API优化性能 optimize-the-performance-using-the-web-service-api
使用Forms API（Web服务）呈现具有优化性能的表单：
-
包含项目文件
- 创建使用Forms服务WSDL的Java代理类。
- 将Java代理类包含在类路径中。
-
创建Forms客户端API对象
创建
FormsService对象并设置身份验证值。 -
设置性能运行时选项
- 使用构造函数创建
PDFFormRenderSpec对象。 - 通过调用
PDFFormRenderSpec对象的setCacheEnabled方法并传递true来设置表单缓存选项。 - 通过调用
PDFFormRenderSpec对象的setStandAlone方法并传递true来设置独立选项。 - 通过调用
PDFFormRenderSpec对象的setLinearizedPDF方法并传递true来设置线性化选项。
- 使用构造函数创建
-
渲染表单
调用
FormsService对象的renderPDFForm方法并传递以下值：- 一个字符串值，它指定窗体设计名称，包括文件扩展名。
- 包含要与表单合并的数据的
BLOB对象。 如果不想合并数据，请传递null。 - 存储运行时选项的
PDFFormRenderSpecc对象。 - 包含Forms服务所需URI值的
URLSpec对象。 - 存储文件附件的
java.util.HashMap对象。 这是一个可选参数，如果您不想将文件附加到表单，则可以指定null。 - 方法填充的空
com.adobe.idp.services.holders.BLOBHolder对象。 用于存储渲染的PDF表单。 - 方法填充的空
javax.xml.rpc.holders.LongHolder对象。 （此参数将存储表单中的页数）。 - 方法填充的空
javax.xml.rpc.holders.StringHolder对象。 （此参数将存储区域设置值）。 - 将包含此操作结果的空
com.adobe.idp.services.holders.FormsResultHolder对象。
renderPDFForm方法使用必须写入客户端Web浏览器的表单数据流填充作为最后一个参数值传递的com.adobe.idp.services.holders.FormsResultHolder对象。 -
将表单数据流写入客户端Web浏览器
- 通过获取
com.adobe.idp.services.holders.FormsResultHolder对象的value数据成员的值创建FormResult对象。 - 创建用于将表单数据流发送到客户端Web浏览器的
javax.servlet.ServletOutputStream对象。 - 通过调用
FormsResult对象的getOutputContent方法，创建包含表单数据的BLOB对象。 - 创建字节数组，并通过调用
BLOB对象的getBinaryData方法填充该数组。 此任务将FormsResult对象的内容分配给字节数组。 - 调用
javax.servlet.http.HttpServletResponse对象的write方法将表单数据流发送到客户端Web浏览器。 将字节数组传递给write方法。
- 通过获取
另请参阅