優化Forms服務的效能

本文中的範例和範例僅適用於AEM Forms的JEE環境。

優化Forms服務的效能

在轉換表單時，您可以設定執行時期選項，以最佳化Forms服務的效能。另一個可以執行的任務是將XDP檔案儲存在儲存庫中，以提高Forms服務的效能。不過，本節不說明如何執行此任務。（請參閱使用Java客戶端庫叫用服務。）

注意

有關Forms服務的詳細資訊，請參閱AEM Forms服務參考。

步驟摘要

要優化Forms服務在生成表單時的效能，請執行以下任務：

包含專案檔案。
建立Forms用戶端API物件。
設定效能運行時選項。
演算表格。
將表單資料流寫入用戶端網頁瀏覽器。

包含專案檔案

將必要的檔案加入您的開發專案中。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用web services，請確定您包含proxy檔案。

建立Forms用戶端API物件

在以寫程式方式執行Forms服務客戶端API操作之前，必須建立Forms服務客戶端。如果您使用Java API，請建立FormsServiceClient物件。如果您使用Forms網站服務API，請建立FormsService物件。

設定效能運行時選項

您可以設定以下效能運行時選項來改進Forms服務的效能：

表單快取:您可以快取在伺服器快取中呈現為PDF的表格。每個表單在首次產生後都會快取。在後續的演算中，如果快取的表單比表單設計的時間戳記還新，則會從快取中擷取表單。通過快取表單，您可以改進Forms服務的效能，因為它不必從儲存庫檢索表單設計。
表單參考線（已過時）的轉換時間可能比其他轉換類型要長。建議您快取表單參考線（已過時），以改善效能。
獨立選項:如果您不要求Forms服務執行伺服器端計算，您可將「單機版」選項設為 true，如此會產生沒有狀態資訊的表單。如果您想要將互動式表單轉譯給使用者，然後使用者將資訊輸入表單並將表單提交回Forms服務，則需要州資訊。然後，Forms服務執行計算操作並將表單呈現給用戶，結果以表單顯示。如果沒有狀態資訊的表單已提交回Forms服務，則只有XML資料可供使用，且不會執行伺服器端計算。
線性化的PDF:組織線性化的PDF檔案，以便在網路環境中提供有效率的漸進式存取。PDF檔案在所有方面都是有效的PDF，並與所有現有檢視器和其他PDF應用程式相容。也就是說，在PDF仍在下載時，可以檢視其線性化。
在用戶端上轉譯PDF表格時，這個選項無法改善效能。
GuideRSL選項:啟用使用執行時期共用程式庫產生表單指南（已過時）的功能。這表示第一個要求會下載較小的SWF檔案，以及儲存在瀏覽器快取中的較大共用程式庫。如需詳細資訊，請參閱Flex檔案中的RSL。
您也可以在用戶端上轉換表格，以改善Forms服務的效能。 (請參閱在客戶端上呈現Forms。)

轉譯表單

若要在設定效能選項後轉換表格，請使用與轉換沒有效能選項的表格相同的應用程式邏輯。

將表單資料串流寫入用戶端網頁瀏覽器

在Forms服務轉譯表單後，它會傳回您必須寫入用戶端網頁瀏覽器的表單資料流。當寫入用戶端網頁瀏覽器時，使用者會看到表單。

另請參閱

使用Java API最佳化效能

使用FormsAPI(Java)演算具最佳效能的表單：

包含專案檔案

在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-forms-client.jar。
建立Forms用戶端API物件
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory對象，建立FormsServiceClient對象。
設定效能運行時選項
- 使用其建構子建立PDFFormRenderSpec對象。
- 調用PDFFormRenderSpec物件的setCacheEnabled方法並傳遞true，以設定表單快取選項。
- 調用PDFFormRenderSpec物件的setLinearizedPDF方法並傳遞true.，以設定線性化選項
轉譯表單

叫用FormsServiceClient物件的renderPDFForm方法並傳遞下列值：
- 指定表單設計名稱的字串值，包括檔案副檔名。
- com.adobe.idp.Document物件，包含要與表單合併的資料。如果您不想合併資料，請傳遞空白的com.adobe.idp.Document物件。
- PDFFormRenderSpec物件，可儲存執行時期選項以改善效能。
- URLSpec物件，包含Forms服務所需的URI值。
- 儲存檔案附件的java.util.HashMap對象。此為可選參數，如果您不想將檔案附加到表單，可以指定null。
renderPDFForm方法返回一個FormsResult對象，該對象包含必須寫入客戶端Web瀏覽器的表單資料流。
將表單資料串流寫入用戶端網頁瀏覽器
- 建立javax.servlet.ServletOutputStream物件，用來傳送表單資料流至用戶端網頁瀏覽器。
- 通過調用FormsResult對象「s getOutputContent」方法建立com.adobe.idp.Document對象。
- 調用com.adobe.idp.Document物件的getInputStream方法，以建立java.io.InputStream物件。
- 建立位元組陣列，並以InputStream物件的read方法來填入表單資料流，並將位元組陣列傳入為引數。
- 叫用javax.servlet.ServletOutputStream物件的write方法，將表單資料串流傳送至用戶端網頁瀏覽器。將位元組陣列傳遞到write方法。

另請參閱

快速入門（SOAP模式）:使用Java API最佳化效能

包含AEM FormsJava庫檔案

設定連接屬性

使用web service API最佳化效能

使用FormsAPI(web service)演算具最佳效能的表單：

包含專案檔案
- 建立使用Forms服務WSDL的Java代理類。
- 將Java代理類包含到類路徑中。
建立Forms用戶端API物件

建立FormsService對象並設定驗證值。
設定效能運行時選項
- 使用其建構子建立PDFFormRenderSpec對象。
- 調用PDFFormRenderSpec物件的setCacheEnabled方法並傳遞true，以設定表單快取選項。
- 調用PDFFormRenderSpec物件的setStandAlone方法並傳遞true，以設定獨立選項。
- 調用PDFFormRenderSpec物件的setLinearizedPDF方法並傳遞true，以設定線性化選項。
轉譯表單

叫用FormsService物件的renderPDFForm方法並傳遞下列值：
- 指定表單設計名稱的字串值，包括檔案副檔名。
- BLOB物件，包含要與表單合併的資料。如果您不想合併資料，請傳遞null。
- 儲存運行時選項的PDFFormRenderSpecc對象。
- URLSpec物件，包含Forms服務所需的URI值。
- 儲存檔案附件的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方法會以必須寫入用戶端網頁瀏覽器的表單資料流填入作為最後一個參數值傳遞的com.adobe.idp.services.holders.FormsResultHolder物件。
將表單資料串流寫入用戶端網頁瀏覽器
- 獲取com.adobe.idp.services.holders.FormsResultHolder對象value資料成員的值，建立FormResult對象。
- 建立javax.servlet.ServletOutputStream物件，用來傳送表單資料流至用戶端網頁瀏覽器。
- 呼叫FormsResult物件的getOutputContent方法，建立包含表單資料的BLOB物件。
- 建立位元組陣列，並呼叫BLOB物件的getBinaryData方法以填入它。此任務將FormsResult對象的內容分配給位元組陣列。
- 叫用javax.servlet.http.HttpServletResponse物件的write方法，將表單資料串流傳送至用戶端網頁瀏覽器。將位元組陣列傳遞到write方法。