最佳化Forms服務的效能

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

最佳化Forms服務的效能

轉譯表單時,您可以設定執行階段選項,以最佳化Forms服務的效能。 為了改善Forms服務的效能,您可以執行的另一項任務是將XDP檔案儲存在存放庫中。 不過,本節不說明如何執行此工作。 (請參閱 使用Java客戶端庫調用服務.)

注意

如需Forms服務的詳細資訊,請參閱 AEM Forms服務參考.

步驟摘要

若要在轉譯表單時最佳化Forms服務的效能,請執行下列工作:

  1. 包含專案檔案。
  2. 建立Forms用戶端API物件。
  3. 設定效能運行時選項。
  4. 轉譯表單。
  5. 將表單資料流寫入客戶端Web瀏覽器。

包含項目檔案

在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。

建立Forms用戶端API物件

您必須先建立Forms服務用戶端,才能以程式設計方式執行Forms服務用戶端API作業。 如果您使用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.)

轉譯表單

若要在設定效能選項後呈現表單,請使用與呈現沒有效能選項的表單相同的應用程式邏輯。

將表單資料流寫入客戶端Web瀏覽器

Forms服務轉譯表單後,會傳回表單資料流,您必須將其寫入用戶端網頁瀏覽器。 寫入客戶端Web瀏覽器時,用戶可以看到該表單。

另請參閱

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

轉譯互動式PDF forms

將Forms轉譯為HTML

建立可轉譯Forms的網頁應用程式

使用Java API最佳化效能

使用Forms API(Java)演算效能最佳的表單:

  1. 包含項目檔案

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

  2. 建立Forms用戶端API物件

    • 建立 ServiceClientFactory 包含連接屬性的對象。
    • 建立 FormsServiceClient 對象,使用其建構子並傳遞 ServiceClientFactory 物件。
  3. 設定效能運行時選項

    • 建立 PDFFormRenderSpec 物件,使用其建構子。
    • 叫用 PDFFormRenderSpec 物件 setCacheEnabled 方法與傳遞 true.
    • 通過調用 PDFFormRenderSpec 物件 setLinearizedPDF 方法與傳遞 true.
  4. 轉譯表單

    叫用 FormsServiceClient 物件 renderPDFForm 方法,並傳遞下列值:

    • 指定表單設計名稱的字串值,包括檔案名副檔名。
    • A com.adobe.idp.Document 包含要與表單合併資料的物件。 如果您不想合併資料,請傳遞空白 com.adobe.idp.Document 物件。
    • A PDFFormRenderSpec 用於儲存運行時選項以提高效能的對象。
    • A URLSpec 包含Forms服務所需URI值的物件。
    • A java.util.HashMap 儲存檔案附件的物件。 這是選用參數,您可以指定 null 如果您不想將檔案附加到表單。

    renderPDFForm 方法傳回 FormsResult 包含必須寫入客戶端web瀏覽器的表單資料流的對象。

  5. 將表單資料流寫入客戶端Web瀏覽器

    • 建立 javax.servlet.ServletOutputStream 用於將表單資料流發送到客戶端web瀏覽器的對象。
    • 建立 com.adobe.idp.Document 對象,方法是調用 FormsResult 物件s getOutputContent 方法。
    • 建立 java.io.InputStream 對象,方法是調用 com.adobe.idp.Document 物件 getInputStream 方法。
    • 建立位元組陣列,並叫用 InputStream 物件 read方法,並將位元組陣列傳遞為引數。
    • 叫用 javax.servlet.ServletOutputStream 物件 write 將表單資料流傳送至用戶端網頁瀏覽器的方法。 將位元組陣列傳遞至 write 方法。

另請參閱

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

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務API最佳化效能

使用Forms API(網站服務)演算效能最佳的表單:

  1. 包含項目檔案

    • 建立使用Forms服務WSDL的Java代理類。
    • 將Java代理類包含到類路徑中。
  2. 建立Forms用戶端API物件

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

  3. 設定效能運行時選項

    • 建立 PDFFormRenderSpec 物件,使用其建構子。
    • 叫用 PDFFormRenderSpec 物件 setCacheEnabled 方法和傳遞true。
    • 叫用 PDFFormRenderSpec 物件 setStandAlone 方法和傳遞true。
    • 通過調用 PDFFormRenderSpec 物件 setLinearizedPDF 方法和傳遞true。
  4. 轉譯表單

    叫用 FormsService 物件 renderPDFForm 方法,並傳遞下列值:

    • 指定表單設計名稱的字串值,包括檔案名副檔名。
    • A BLOB 包含要與表單合併資料的物件。 如果您不想合併資料,請傳遞 null.
    • A PDFFormRenderSpecc 儲存運行時選項的對象。
    • A URLSpec 包含Forms服務所需URI值的物件。
    • A 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 作為最後一個引數值傳遞的物件,具有必須寫入用戶端網頁瀏覽器的表單資料流。

  5. 將表單資料流寫入客戶端Web瀏覽器

    • 建立 FormResult 物件,方法是取得 com.adobe.idp.services.holders.FormsResultHolder 物件 value 資料成員。
    • 建立 javax.servlet.ServletOutputStream 用於將表單資料流發送到客戶端web瀏覽器的對象。
    • 建立 BLOB 包含表單資料的物件,方法是叫用 FormsResult 物件 getOutputContent 方法。
    • 建立位元組陣列,並叫用 BLOB 物件 getBinaryData 方法。 此任務分配 FormsResult 位元組陣列的物件。
    • 叫用 javax.servlet.http.HttpServletResponse 物件 write 將表單資料流傳送至用戶端網頁瀏覽器的方法。 將位元組陣列傳遞至 write 方法。

另請參閱

使用Base64編碼叫用AEM Forms

本頁內容