處理已提交的Forms handling-submitted-forms

包含項目檔案

在Java專案的類別路徑中加入用戶端JAR檔案，例如adobe-forms-client.jar。

建立Forms用戶端API物件

• 建立 ServiceClientFactory 包含連接屬性的對象。
• 建立 FormsServiceClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。

擷取表單資料

• 若要擷取張貼至Java Servlet的表單資料，請建立 com.adobe.idp.Document 對象，使用其建構子並調用 javax.servlet.http.HttpServletResponse 物件 getInputStream 方法。
• 建立 RenderOptionsSpec 物件，使用其建構子。 調用 RenderOptionsSpec 物件 setLocale 方法，並傳遞指定區域設定的字串值。

• 叫用 FormsServiceClient 物件 processFormSubmission 方法，並傳遞下列值：

  • 此 com.adobe.idp.Document 包含表單資料的物件。
  • 一個字串值，它指定包括所有相關HTTP標題的環境變數。 指定要處理的內容類型。 要處理XML資料，請為此參數指定以下字串值： CONTENT_TYPE=text/xml. 若要處理PDF資料，請為此參數指定下列字串值： CONTENT_TYPE=application/pdf.
  • 指定 HTTP_USER_AGENT 標題值，例如。 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)。此參數值為選用值。
  • A RenderOptionsSpec 儲存運行時選項的對象。

  此 processFormSubmission 方法傳回 FormsResult 包含表單提交結果的物件。

• 判斷Forms服務是否已借由叫用 FormsResult 物件 getAction 方法。 如果此方法傳回值 0，則資料已準備好供處理。

確定表單提交是否包含檔案附件

• 叫用 FormsResult 物件 getAttachments 方法。 此方法會傳回 java.util.List 包含隨表單提交的檔案的物件。
• 重複 java.util.List 物件，以判斷是否有檔案附件。 如果有檔案附件，則每個元素都是 com.adobe.idp.Document 例項。 您可以叫用 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File 物件。

處理提交的資料

• 如果資料內容類型為 application/vnd.adobe.xdp+xml 或 text/xml，建立應用程式邏輯以擷取XML資料值。

  • 建立 com.adobe.idp.Document 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
  • 建立 java.io.InputStream 對象，方法是調用 java.io.DataInputStream 建構子和傳遞 com.adobe.idp.Document 物件。
  • 建立 org.w3c.dom.DocumentBuilderFactory 物件，方法是呼叫靜態 org.w3c.dom.DocumentBuilderFactory 物件 newInstance 方法。
  • 建立 org.w3c.dom.DocumentBuilder 對象，方法是調用 org.w3c.dom.DocumentBuilderFactory 物件 newDocumentBuilder 方法。
  • 建立 org.w3c.dom.Document 對象，方法是調用 org.w3c.dom.DocumentBuilder 物件 parse 方法和傳遞 java.io.InputStream 物件。
  • 檢索XML文檔中每個節點的值。 完成此工作的一種方式是建立接受兩個參數的自訂方法：the org.w3c.dom.Document 對象和要檢索其值的節點的名稱。 此方法會傳回代表節點值的字串值。 在此程式後的程式碼範例中，此自訂方法稱為 getNodeText. 此方法的內文如所示。

• 如果資料內容類型為 application/pdf，建立應用程式邏輯，將提交的PDF資料儲存為PDF檔案。

  • 建立 com.adobe.idp.Document 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
  • 建立 java.io.File 物件，使用其公用建構函式。 請務必將PDF指定為副檔名。
  • 叫用以填入PDF檔案 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File 物件。

包含項目檔案

• 建立使用Forms服務WSDL的Java代理類。
• 將Java代理類包含到類路徑中。

建立Forms用戶端API物件

建立 FormsService 對象和設定驗證值。

擷取表單資料

• 若要擷取張貼至Java Servlet的表單資料，請建立 BLOB 物件，使用其建構子。

• 建立 java.io.InputStream 對象，方法是調用 javax.servlet.http.HttpServletResponse 物件 getInputStream 方法。

• 建立 java.io.ByteArrayOutputStream 對象，使用其建構子並傳遞長度 java.io.InputStream 物件。

• 複製 java.io.InputStream 物件 java.io.ByteArrayOutputStream 物件。

• 叫用 java.io.ByteArrayOutputStream 物件 toByteArray 方法。

• 填入 BLOB 對象 setBinaryData 方法，並將位元組陣列傳遞為引數。

• 建立 RenderOptionsSpec 物件，使用其建構子。 調用 RenderOptionsSpec 物件 setLocale 方法，並傳遞指定區域設定的字串值。

• 叫用 FormsService 物件 processFormSubmission 方法，並傳遞下列值：

  • 此 BLOB 包含表單資料的物件。
  • 一個字串值，它指定包括所有相關HTTP標題的環境變數。 指定要處理的內容類型。 要處理XML資料，請為此參數指定以下字串值： CONTENT_TYPE=text/xml. 若要處理PDF資料，請為此參數指定下列字串值： CONTENT_TYPE=application/pdf.
  • 指定 HTTP_USER_AGENT 標題值；例如， Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
  • A RenderOptionsSpec 儲存運行時選項的對象。
  • 空白 BLOBHolder 由方法填入的物件。
  • 空白 javax.xml.rpc.holders.StringHolder 由方法填入的物件。
  • 空白 BLOBHolder 由方法填入的物件。
  • 空白 BLOBHolder 由方法填入的物件。
  • 空白 javax.xml.rpc.holders.ShortHolder 由方法填入的物件。
  • 空白 MyArrayOf_xsd_anyTypeHolder 由方法填入的物件。 此參數用於儲存隨表單提交的檔案附件。
  • 空白 FormsResultHolder 由方法填入且已提交表單的物件。

  此 processFormSubmission 方法填入 FormsResultHolder 參數與表單提交結果。

• 判斷Forms服務是否已借由叫用 FormsResult 物件 getAction 方法。 如果此方法傳回值 0，表單資料就緒即可處理。 您可以取得 FormsResult 物件，方法是取得 FormsResultHolder 物件 value 資料成員。

確定表單提交是否包含檔案附件

取得 MyArrayOf_xsd_anyTypeHolder 物件 value 資料成員( MyArrayOf_xsd_anyTypeHolder 物件已傳遞至 processFormSubmission 方法)。 此資料成員返回 Objects. 內的每個元素 Object 陣列是 Object與隨表單提交的檔案對應。 您可以取得陣列內的每個元素，並將其轉換為 BLOB 物件。

處理提交的資料

• 如果資料內容類型為 application/vnd.adobe.xdp+xml 或 text/xml，建立應用程式邏輯以擷取XML資料值。

  • 建立 BLOB 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
  • 叫用 BLOB 物件 getBinaryData 方法。
  • 建立 java.io.InputStream 對象，方法是調用 java.io.ByteArrayInputStream 建構函式並傳遞位元組陣列。
  • 建立 org.w3c.dom.DocumentBuilderFactory 物件，方法是呼叫靜態 org.w3c.dom.DocumentBuilderFactory 物件 newInstance 方法。
  • 建立 org.w3c.dom.DocumentBuilder 對象，方法是調用 org.w3c.dom.DocumentBuilderFactory 物件 newDocumentBuilder 方法。
  • 建立 org.w3c.dom.Document 對象，方法是調用 org.w3c.dom.DocumentBuilder 物件 parse 方法和傳遞 java.io.InputStream 物件。
  • 檢索XML文檔中每個節點的值。 完成此工作的一種方式是建立接受兩個參數的自訂方法：the org.w3c.dom.Document 對象和要檢索其值的節點的名稱。 此方法會傳回代表節點值的字串值。 在此程式後的程式碼範例中，此自訂方法稱為 getNodeText. 此方法的內文如所示。

• 如果資料內容類型為 application/pdf，建立應用程式邏輯，將提交的PDF資料儲存為PDF檔案。

  • 建立 BLOB 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
  • 叫用 BLOB 物件 getBinaryData 方法。
  • 建立 java.io.File 物件，使用其公用建構函式。 請務必將PDF指定為副檔名。
  • 建立 java.io.FileOutputStream 對象，使用其建構子並傳遞 java.io.File 物件。
  • 叫用以填入PDF檔案 java.io.FileOutputStream 物件 write 方法，並傳遞位元組陣列。