创建可渲染Forms的Web应用程序

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

创建可渲染Forms的Web应用程序

您可以创建基于Web的应用程序,该应用程序使用Java Servlet调用Forms服务并渲染表单。 使用Java™ Servlet的一个好处是,您可以将进程的返回值写入客户端Web浏览器。 也就是说,Java servlet可用作返回表单的Forms服务与客户端Web浏览器之间的链接。

注意

本节介绍如何创建基于Web的应用程序,该应用程序使用调用Forms服务的Java Servlet并基于片段呈现表单。 (请参阅 基于片段渲染Forms.)

使用Java Servlet,您可以将表单写入客户端Web浏览器,以便客户可以查看并将数据输入到表单中。 在使用数据填充表单后,Web用户单击表单上的提交按钮,以将信息发送回Java Servlet,在Java Servlet中可以检索和处理数据。 例如,数据可以发送到另一个进程。

本节讨论如何创建基于Web的应用程序,以便用户选择基于美国的表单数据或基于加拿大的表单数据,如下图所示。

cw_cw_fragmentwebclient

呈现的表单是基于片段的表单。 也就是说,如果用户选择美国数据,则返回的表单将使用基于美国数据的片段。 例如,表单的页脚包含一个美国地址,如下图所示。

cw_cw_fragementformfooter

同样,如果用户选择加拿大数据,则返回的表单包含加拿大地址,如下图所示。

cw_cw_fragementformfootercnd

注意

有关基于片段创建表单设计的信息,请参阅 Forms Designer.

示例文件

此部分使用可位于以下位置的示例文件:

<Forms Designer安装目录>/Samples/Forms/采购订单/表单片段

where <安装目录>是安装路径。 出于客户端应用程序的目的,从此安装位置复制了Purchase Order Dynamic.xdp文件,并将其部署到名为的Forms应用程序 应用程序/表单应用程序. Purchase Order Dynamic.xdp文件放置在名为FormsFolder的文件夹中。 同样,片段也放置在名为片段的文件夹中,如下图所示。

cw_cw_fragments存储库

要访问Purchase Order Dynamic.xdp表单设计,请指定 Applications/FormsApplication/1.0/FormsFolder/Purchase Order Dynamic.xdp 作为表单名称(传递到 renderPDFForm 方法)和 repository:/// 作为内容根URI值。

Web应用程序使用的XML数据文件已从Data文件夹移至 C:\Adobe(属于托管AEM Forms的J2EE应用程序服务器的文件系统)。 文件名为Purchase Order Canada.xml 和采购订单 US.xml.

注意

有关使用Workbench创建Forms应用程序的信息,请参阅 Workbench帮助.

步骤摘要

要创建基于Web的应用程序以根据片段呈现表单,请执行以下步骤:

  1. 创建新Web项目。
  2. 创建表示Java Servlet的Java应用程序逻辑。
  3. 为Web应用程序创建网页。
  4. 将Web应用程序打包到WAR文件。
  5. 将WAR文件部署到J2EE应用程序服务器。
  6. 测试Web应用程序。
注意

其中某些步骤取决于部署了AEM Forms的J2EE应用程序。 例如,您用于部署WAR文件的方法取决于您所使用的J2EE应用程序服务器。 本节假定AEM Forms已部署在JBoss®上。

创建Web项目

创建包含可调用Forms服务的Java Servlet的Web应用程序的第一步是创建一个新的Web项目。 本文档所基于的Java IDE是Eclipse 3.3。使用Eclipse IDE,创建一个Web项目并将所需的JAR文件添加到您的项目中。 最后,添加一个名为的HTML页面 index.html 和Java Servlet添加到您的项目。

以下列表指定了必须添加到Web项目的JAR文件:

  • adobe-forms-client.jar
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar

有关这些JAR文件的位置,请参阅 包括AEM Forms Java库文件.

要创建Web项目,请执行以下操作:

  1. 启动Eclipse并单击 文件 > 新建项目.
  2. 新建项目 对话框,选择 Web > 动态Web项目.
  3. 类型 FragmentsWebApplication ,然后单击 完成.

要将所需的JAR文件添加到您的项目,请执行以下操作:

  1. 在“项目资源管理器”窗口中,右键单击 FragmentsWebApplication 项目,选择 属性.
  2. 单击 Java构建路径 ,然后单击 选项卡。
  3. 单击 添加外部JAR 按钮并浏览到要包含的JAR文件。

要向项目添加Java Servlet,请执行以下操作:

  1. 在“项目资源管理器”窗口中,右键单击 FragmentsWebApplication 项目,选择 新建 > 其他.
  2. 展开 Web 文件夹,选择 Servlet,然后单击 下一个.
  3. 在“创建Servlet”对话框中,键入 RenderFormFragment ,然后单击 完成.

要向项目添加HTML页面,请执行以下操作:

  1. 在“项目资源管理器”窗口中,右键单击 FragmentsWebApplication 项目,选择 新建 > 其他.
  2. 展开 Web 文件夹,选择 HTML,然后单击 下一个.
  3. 在“新建HTML”对话框中,键入 index.html ,然后单击 完成.
注意

有关创建调用的HTML页面的信息 RenderFormFragment Java Servlet,请参阅 创建网页.

为Servlet创建Java应用程序逻辑

您可以在Java servlet内创建用于调用Forms服务的Java应用程序逻辑。 以下代码显示 RenderFormFragment Java Servlet:

     public class RenderFormFragment extends HttpServlet implements Servlet {
         public void doGet(HttpServletRequest req, HttpServletResponse resp
         throws ServletException, IOException {
         doPost(req,resp);

         }
         public void doPost(HttpServletRequest req, HttpServletResponse resp
         throws ServletException, IOException {
             //Add code here to invoke the Forms service
             }

通常,您不会将客户端代码放在Java Servlet的 doGetdoPost 方法。 一个更好的编程实践是将此代码放置在一个单独的类中,从中实例化该类 doPost 方法(或 doGet 方法),并调用相应的方法。 但是,对于代码简短性,此部分中的代码示例将保持为最小值,并且代码示例位于 doPost 方法。

要使用Forms服务API渲染基于片段的表单,请执行以下任务:

  1. 在Java项目的类路径中包含客户端JAR文件,如adobe-forms-client.jar。 有关这些文件位置的信息,请参阅 包括AEM Forms Java库文件.

  2. 检索从HTML表单提交的单选按钮的值,并指定是使用美国数据还是加拿大数据。 如果提交了美国用户,请创建 com.adobe.idp.Document 存储位于 采购订单US.xml. 同样,如果是加拿大人,则创建 com.adobe.idp.Document 存储位于 采购订单Canada.xml 文件。

  3. 创建 ServiceClientFactory 包含连接属性的对象。 (请参阅 设置连接属性.)

  4. 创建 FormsServiceClient 对象,并使用其构造函数进行传递 ServiceClientFactory 对象。

  5. 创建 URLSpec 使用其构造函数存储URI值的对象。

  6. 调用 URLSpec 对象 setApplicationWebRoot 方法,并传递表示应用程序web根的字符串值。

  7. 调用 URLSpec 对象 setContentRootURI 方法,并传递指定内容根URI值的字符串值。 确保表单设计和片段位于内容根URI中。 如果没有,则Forms服务会引发异常。 要引用AEM Forms存储库,请指定 repository://.

  8. 调用 URLSpec 对象 setTargetURL 方法,并传递一个字符串值,该值指定将表单数据发布到的目标URL值。 如果在表单设计中定义目标URL,则可以传递一个空字符串。 您还可以指定将表单发送到的URL,以执行计算。

  9. 调用 FormsServiceClient 对象 renderPDFForm 方法并传递以下值:

    • 指定表单设计名称(包括文件扩展名)的字符串值。
    • A com.adobe.idp.Document 包含要与表单合并的数据的对象(在步骤2中创建)。
    • A PDFFormRenderSpec 用于存储运行时选项的对象。 有关更多信息,请参阅 AEM Forms API参考.
    • A URLSpec 包含Forms服务根据片段渲染表单所需URI值的对象。
    • A java.util.HashMap 用于存储文件附件的对象。 这是一个可选参数,您可以指定 null 如果您不想将文件附加到表单。

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

  10. 创建 com.adobe.idp.Document 对象 FormsResult 对象s getOutputContent 方法。

  11. 获取的内容类型 com.adobe.idp.Document 通过调用对象 getContentType 方法。

  12. 设置 javax.servlet.http.HttpServletResponse 对象的内容类型(通过调用 setContentType 方法和传递 com.adobe.idp.Document 对象。

  13. 创建 javax.servlet.ServletOutputStream 用于通过调用将表单数据流写入客户端web浏览器的对象 javax.servlet.http.HttpServletResponse 对象 getOutputStream 方法。

  14. 创建 java.io.InputStream 对象 com.adobe.idp.Document 对象 getInputStream 方法。

  15. 通过调用 InputStream 对象 read方法并将字节数组作为参数进行传递。

  16. 调用 javax.servlet.ServletOutputStream 对象 write 将表单数据流发送到客户端web浏览器的方法。 将字节数组传递到 write 方法。

以下代码示例表示调用Forms服务并基于片段呈现表单的Java Servlet。

 /*
     * This Java Quick Start uses the following JAR files
     * 1. adobe-forms-client.jar
     * 2. adobe-livecycle-client.jar
     * 3. adobe-usermanager-client.jar
     *
     * (Because Forms quick starts are implemented as Java servlets, it is
     * not necessary to include J2EE specific JAR files - the Java project
     * that contains this quick start is exported as a WAR file which
     * is deployed to the J2EE application server)
     *
     * These JAR files are located in the following path:
     * <install directory>/sdk/client-libs
     *
     * For complete details about the location of these JAR files,
     * see "Including AEM Forms library files" in Programming with AEM forms
     */
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.IOException;
 import java.io.PrintWriter;

 import javax.servlet.Servlet;
 import javax.servlet.ServletException;
 import javax.servlet.ServletOutputStream;
 import javax.servlet.http.HttpServlet;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 import com.adobe.livecycle.formsservice.client.*;
 import java.util.*;
 import java.io.InputStream;
 import java.net.URL;

 import com.adobe.idp.Document;
 import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;
 import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties;

 public class RenderFormFragment extends HttpServlet implements Servlet {

     public void doGet(HttpServletRequest req, HttpServletResponse resp)
         throws ServletException, IOException {
             doPost(req,resp);

     }
     public void doPost(HttpServletRequest req, HttpServletResponse resp)
     throws ServletException, IOException {



         try{
             //Set connection properties required to invoke AEM Forms
             Properties connectionProps = new Properties();
             connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "https://'[server]:[port]'");
             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");

             //Get the value of selected radio button
             String radioValue = req.getParameter("radio");

             //Create an Document object to store form data
             Document oInputData = null;

             //The value of the radio button determines the form data to use
             //which determines which fragments used in the form
             if (radioValue.compareTo("AMERICAN") == 0)            {
                 FileInputStream myData = new FileInputStream("C:\\Adobe\Purchase Order US.xml");
                 oInputData = new Document(myData);
             }
             else if (radioValue.compareTo("CANADIAN") == 0)            {
                 FileInputStream myData = new FileInputStream("C:\\Adobe\Purchase Order Canada.xml");
                 oInputData = new Document(myData);
             }

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

             //Create a FormsServiceClient object
             FormsServiceClient formsClient = new FormsServiceClient(myFactory);

             //Set the parameter values for the renderPDFForm method
             String formName = "Applications/FormsApplication/1.0/FormsFolder/Purchase Order Dynamic.xdp";

             //Cache the PDF form
             PDFFormRenderSpec pdfFormRenderSpec = new PDFFormRenderSpec();
             pdfFormRenderSpec.setCacheEnabled(new Boolean(true));

             //Specify URI values that are required to render a form
             //design based on fragments
             URLSpec uriValues = new URLSpec();
             uriValues.setApplicationWebRoot("https://'[server]:[port]'/RenderFormFragment");
             uriValues.setContentRootURI("repository:///");
             uriValues.setTargetURL("https://'[server]:[port]'/FormsServiceClientApp/HandleData");

             //Invoke the renderPDFForm method and write the
             //results to a client web browser
             FormsResult formOut = formsClient.renderPDFForm(
                         formName,               //formQuery
                         oInputData,             //inDataDoc
                         pdfFormRenderSpec,      //PDFFormRenderSpec
                         uriValues,                //urlSpec
                         null                    //attachments
                         );

             //Create a Document object that stores form data
             Document myData = formOut.getOutputContent();

             //Get the content type of the response and
             //set the HttpServletResponse object’s content type
             String contentType = myData.getContentType();
             resp.setContentType(contentType);

             //Create a ServletOutputStream object
             ServletOutputStream oOutput = resp.getOutputStream();

             //Create an InputStream object
             InputStream inputStream = myData.getInputStream();

             //Write the data stream to the web browser
             byte[] data = new byte[4096];
             int bytesRead = 0;
             while ((bytesRead = inputStream.read(data)) > 0)
             {
                 oOutput.write(data, 0, bytesRead);
             }

         }catch (Exception e) {
              System.out.println("The following exception occurred: "+e.getMessage());
       }
     }
 }

创建网页

index.html网页提供Java servlet的入口点并调用Forms服务。 此网页是一个基本的HTML表单,其中包含两个单选按钮和一个提交按钮。 单选按钮的名称是单选按钮。 当用户单击提交按钮时,表单数据会发布到 RenderFormFragment Java Servlet。

Java Servlet使用以下Java代码捕获从HTML页面发布的数据:

             Document oInputData = null;

             //Get the value of selected radio button
             String radioValue = req.getParameter("radio");

             //The value of the radio button determines the form data to use
             //which determines which fragments used in the form
             if (radioValue.compareTo("AMERICAN") == 0)            {
                 FileInputStream myData = new FileInputStream("C:\\Adobe\Purchase Order US.xml");
                 oInputData = new Document(myData);
             }
             else if (radioValue.compareTo("CANADIAN") == 0)            {
                 FileInputStream myData = new FileInputStream("C:\\Adobe\Purchase Order Canada.xml");
                 oInputData = new Document(myData);
             }

以下HTML代码位于在开发环境设置期间创建的index.html文件中。 (请参阅 创建Web项目.)

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="https://www.w3.org/1999/xhtml">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <title>Untitled Document</title>
 </head>

 <body>
 <form name="myform" action="https://'[server]:[port]'/FragmentsWebApplication/RenderFormFragment" method="post">
      <table>
      <tr>
        <th>Forms Fragment Web Client</th>
      </tr>
      <tr>
        <td>
          <label>
          <input type="radio" name="radio" id="radio_Data" value="CANADIAN" />
          Canadian data<br />
          </label>
          <p>
            <label>
            <input type="radio" name="radio" id="radio_Data" value="AMERICAN" checked/>
            American data</label>
          </p>
        </td>
      </tr>
      <tr>
      <td>
        <label>
          <input type="submit" name="button_Submit" id="button_Submit" value="Submit" />
            </label>
            </td>
         </tr>
        </table>
      </form>
 </body>
 </html>

打包Web应用程序

要部署调用Forms服务的Java Servlet,请将您的Web应用程序打包到WAR文件。 请确保组件业务逻辑所依赖的外部JAR文件(例如adobe-livecycle-client.jar和adobe-forms-client.jar)也包含在WAR文件中。

要将Web应用程序打包到WAR文件,请执行以下操作:

  1. 项目资源管理器 窗口,右键单击 FragmentsWebApplication 项目,选择 导出 > 战争文件.
  2. Web模块 文本框,文字 FragmentsWebApplication ,以获取Java项目的名称。
  3. 目标 文本框,文字 FragmentsWebApplication.war对于​文件名,指定WAR文件的位置,然后单击“完成”。

将WAR文件部署到J2EE应用程序服务器

您可以将WAR文件部署到部署了AEM Forms的J2EE应用程序服务器。 部署WAR文件后,您可以使用Web浏览器访问HTML网页。

要将WAR文件部署到J2EE应用程序服务器,请执行以下操作:

  • 将WAR文件从导出路径复制到 [Forms Install]\Adobe\Adobe Experience Manager Forms\jboss\server\all\deploy.

测试Web应用程序

部署Web应用程序后,可以使用Web浏览器对其进行测试。 假定您使用的是托管AEM Forms的同一台计算机,则可以指定以下URL:

  • http://localhost:8080/FragmentsWebApplication/index.html

    选择单选按钮,然后单击“提交”按钮。 基于片段的表单将显示在Web浏览器中。 如果出现问题,请参阅J2EE应用程序服务器的日志文件。

在此页面上