使用CustomToolbars渲染HTMLForms rendering-html-forms-with-customtoolbars

包含项目文件

在Java项目的类路径中包含客户端JAR文件，例如adobe-forms-client.jar。

创建Forms Java API对象

• 创建 ServiceClientFactory 包含连接属性的对象。
• 创建 FormsServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。

引用自定义fscmenu XML文件

• 创建 HTMLRenderSpec 对象。
• 要使用工具栏呈现HTML表单，请调用 HTMLRenderSpec 对象的 setHTMLToolbar 方法和传递 HTMLToolbar 枚举值。 例如，要显示垂直HTML工具栏，请传递 HTMLToolbar.Vertical.
• 通过调用 HTMLRenderSpec 对象的 setToolbarURI 方法，并传递一个指定XML文件的URI位置的字符串值。
• 如果适用，通过调用 HTMLRenderSpec 对象的 setLocale 方法，并传递一个指定区域设置值的字符串值。 默认值为English。

呈现HTML表单

调用 FormsServiceClient 对象的 renderHTMLForm 方法并传递以下值：

• 一个字符串值，它指定窗体设计名称，包括文件扩展名。 如果您引用的表单设计是Forms应用程序的一部分，请确保您指定完整的路径，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
• A TransformTo 用于指定HTML首选项类型的枚举值。 例如，要呈现与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单，请指定 TransformTo.MSDHTML.
• A com.adobe.idp.Document 包含要与表单合并的数据的对象。 如果不想合并数据，请传递一个空值 com.adobe.idp.Document 对象。
• 此 HTMLRenderSpec 存储HTML运行时选项的对象。
• 一个字符串值，它指定 HTTP_USER_AGENT 标头值，如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
• A URLSpec 用于存储呈现HTML表单所需的URI值的对象。
• A java.util.HashMap 存储文件附件的对象。 这是一个可选参数，您可以指定 null 如果您不想将文件附加到表单。

此 renderHTMLForm 方法返回 FormsResult 包含必须写入客户端Web浏览器的表单数据流的对象。

将表单数据流写入客户端Web浏览器

• 创建 com.adobe.idp.Document 对象，方法是调用 FormsResult 对象 getOutputContent 方法。
• 获取的内容类型 com.adobe.idp.Document 对象(通过调用其 getContentType 方法。
• 设置 javax.servlet.http.HttpServletResponse 通过调用对象的内容类型 setContentType 方法和传递的内容类型 com.adobe.idp.Document 对象。
• 创建 javax.servlet.ServletOutputStream 用于通过调用 javax.servlet.http.HttpServletResponse 对象的 getOutputStream 方法。
• 创建 java.io.InputStream 对象，方法是调用 com.adobe.idp.Document 对象的 getInputStream 方法。
• 创建字节数组，并通过调用 InputStream 对象的 read 方法并将字节数组作为参数传递。
• 调用 javax.servlet.ServletOutputStream 对象的 write 将表单数据流发送到客户端Web浏览器的方法。 将字节数组传递给 write 方法。

包含项目文件

• 创建使用Forms服务WSDL的Java代理类。
• 在类路径中包含Java代理类。

创建Forms Java API对象

创建 FormsService 对象并设置身份验证值。

引用自定义fscmenu XML文件

• 创建 HTMLRenderSpec 对象。
• 要使用工具栏呈现HTML表单，请调用 HTMLRenderSpec 对象的 setHTMLToolbar 方法和传递 HTMLToolbar 枚举值。 例如，要显示垂直HTML工具栏，请传递 HTMLToolbar.Vertical.
• 通过调用 HTMLRenderSpec 对象的 setToolbarURI 方法，并传递一个指定XML文件的URI位置的字符串值。
• 如果适用，通过调用 HTMLRenderSpec 对象的 setLocale 方法，并传递一个指定区域设置值的字符串值。 默认值为English。

呈现HTML表单

调用 FormsService 对象的 renderHTMLForm 方法并传递以下值：

• 一个字符串值，它指定窗体设计名称，包括文件扩展名。 如果您引用的表单设计是Forms应用程序的一部分，请确保您指定完整的路径，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
• A TransformTo 用于指定HTML首选项类型的枚举值。 例如，要呈现与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单，请指定 TransformTo.MSDHTML.
• A BLOB 包含要与表单合并的数据的对象。 如果不想合并数据，请传递 null.
• 此 HTMLRenderSpec 存储HTML运行时选项的对象。
• 一个字符串值，它指定 HTTP_USER_AGENT 标头值，如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)。 如果您不想设置此值，则可以传递空字符串。
• A URLSpec 用于存储呈现HTML表单所需的URI值的对象。
• A java.util.HashMap 存储文件附件的对象。 此参数是可选的，您可以指定 null 如果您不打算将文件附加到表单。
• 空的 com.adobe.idp.services.holders.BLOBHolder 由填充的对象 renderHTMLForm 方法。 此参数值存储渲染的表单。
• 空的 com.adobe.idp.services.holders.BLOBHolder 由填充的对象 renderHTMLForm 方法。 此参数存储输出XML数据。
• 空的 javax.xml.rpc.holders.LongHolder 由填充的对象 renderHTMLForm 方法。 此参数存储表单中的页数。
• 空的 javax.xml.rpc.holders.StringHolder 由填充的对象 renderHTMLForm 方法。 此参数存储区域设置值。
• 空的 javax.xml.rpc.holders.StringHolder 由填充的对象 renderHTMLForm 方法。 此参数用于存储使用的HTML渲染值。
• 空的 com.adobe.idp.services.holders.FormsResultHolder 将包含此操作结果的对象。

此 renderHTMLForm 方法填充 com.adobe.idp.services.holders.FormsResultHolder 作为最后一个参数值传递的对象，该对象具有必须写入客户端Web浏览器的表单数据流。

将表单数据流写入客户端Web浏览器

• 创建 FormResult 对象，方法是获取 com.adobe.idp.services.holders.FormsResultHolder 对象的 value 数据成员。
• 创建 BLOB 通过调用 FormsResult 对象的 getOutputContent 方法。
• 获取的内容类型 BLOB 对象(通过调用其 getContentType 方法。
• 设置 javax.servlet.http.HttpServletResponse 通过调用对象的内容类型 setContentType 方法和传递的内容类型 BLOB 对象。
• 创建 javax.servlet.ServletOutputStream 用于通过调用 javax.servlet.http.HttpServletResponse 对象的 getOutputStream 方法。
• 创建字节数组，并通过调用 BLOB 对象的 getBinaryData 方法。 此任务分配 FormsResult 对象。
• 调用 javax.servlet.http.HttpServletResponse 对象的 write 将表单数据流发送到客户端Web浏览器的方法。 将字节数组传递给 write 方法。