Forms サービスパフォーマンスの最適化 optimizing-the-performance-of-theforms-service

プロジェクトファイルを含める

adobe-forms-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

Forms Client API オブジェクトの作成

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• FormsServiceClient オブジェクトを作成するには、コンストラクターを使用して ServiceClientFactory オブジェクトを渡します。

パフォーマンスの実行時オプションの設定

• コンストラクターを使用して PDFFormRenderSpec オブジェクトを作成します。
• フォームキャッシュオプションを設定するには、PDFFormRenderSpec オブジェクトの setCacheEnabled メソッドを呼び出して、true を渡します。
• 線形化オプションを設定するには、PDFFormRenderSpec オブジェクトの setLinearizedPDF メソッドを呼び出して、true. を渡します。

フォームのレンダリング

FormsServiceClient オブジェクトの renderPDFForm メソッドを呼び出して、次の値を渡します。

• ファイル名拡張子を含んだフォームデザイン名を指定する文字列値。
• フォームに結合するデータを含む com.adobe.idp.Document オブジェクト。データを結合しない場合は、空の com.adobe.idp.Document オブジェクトを渡します。
• パフォーマンスを向上させるための実行時オプションを保存する PDFFormRenderSpec オブジェクト。
• Forms サービスで必要な URI 値を格納する URLSpec オブジェクト。
• 添付ファイルを保存する java.util.HashMap オブジェクト。オプションのパラメーターです。フォームにファイルを添付しない場合は null を指定できます。

renderPDFForm メソッドは、クライアントの Web ブラウザーに書き込む必要のあるフォームデータストリームを含む FormsResult オブジェクトを返します。

フォームデータストリームをクライアント web ブラウザーに書き込む

• フォームデータストリームをクライアントの web ブラウザーに送信するために使用する javax.servlet.ServletOutputStream オブジェクトを作成します。
• FormsResult オブジェクトの getOutputContent メソッドを呼び出すことによって、com.adobe.idp.Document オブジェクトを作成します。
• com.adobe.idp.Document オブジェクトの getInputStream メソッドを呼び出して、java.io.InputStream オブジェクトを作成します。
• バイト配列を作成し、フォームデータストリームを入力するには、InputStream オブジェクトの read メソッドを呼び出して、バイト配列を引数として渡します。
• javax.servlet.ServletOutputStream オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。バイト配列を write メソッドに渡します。

プロジェクトファイルを含める

• Forms Service WSDL を使用する Java プロキシクラスを作成します。
• Java プロキシクラスをクラスパスに含めます。

Forms Client API オブジェクトの作成

FormsService オブジェクトを作成し、認証値を設定します。

パフォーマンスの実行時オプションの設定

• コンストラクターを使用して PDFFormRenderSpec オブジェクトを作成します。
• フォームキャッシュオプションを設定するには、PDFFormRenderSpec オブジェクトの setCacheEnabled メソッドを呼び出して、true を渡します。
• スタンドアロンオプションを設定するには、PDFFormRenderSpec オブジェクトの setStandAlone メソッドを呼び出して、true を渡します。
• 線形化オプションを設定するには、PDFFormRenderSpec オブジェクトの setLinearizedPDF メソッドを呼び出して、true を渡します。

フォームのレンダリング

FormsService オブジェクトの renderPDFForm メソッドを呼び出して、次の値を渡します。

• ファイル名拡張子を含んだフォームデザイン名を指定する文字列値。
• フォームに結合するデータを含む BLOB オブジェクト。データを結合しない場合は、null を渡します。
• 実行時オプションを保存する PDFFormRenderSpecc オブジェクト。
• Forms サービスで必要な URI 値を格納する URLSpec オブジェクト。
• 添付ファイルを保存する 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 オブジェクトに、クライアント web ブラウザーに書き込む必要のあるフォームデータストリームを入力します。

フォームデータストリームをクライアント web ブラウザーに書き込む

• com.adobe.idp.services.holders.FormsResultHolder オブジェクトの value データメンバーの値を取得して、FormResult オブジェクトを作成します。
• フォームデータストリームをクライアントの web ブラウザーに送信するために使用する javax.servlet.ServletOutputStream オブジェクトを作成します。
• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、フォームデータを含む BLOB オブジェクトを作成します。
• バイト配列を作成し、BLOB オブジェクトの getBinaryData メソッドを呼び出して、入力します。このタスクは、FormsResult オブジェクトのコンテンツをバイト配列に割り当てます。
• javax.servlet.http.HttpServletResponse オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。バイト配列を write メソッドに渡します。